API REFERENCE

Video

Eşzamansız görev modeliyle video klipler oluşturun; bir bilgi istemi gönderin, durumu yoklayın, sonucu alın.

Video oluşturma arka planda çalışır; akış oluşturma işlemi yoktur. Akış her zaman şu şekildedir: görev oluştur → durumu yokla → MP4'ü indir. Görevler 24 saat sonra sona erer.

1. Bir görev oluşturun

İşi gönderir ve bir görev kimliği döndürür. Maliyet, seçilen model için süre × saniye başına fiyat esas alınarak peşin olarak borçlandırılır.

POSThttps://api.airforce/v1/video/generations

Video modelleri

…· live

Parameter	Type	Required	Description
model	string	Required	Video model ID. Use /v1/models and filter by output_modalities.includes("video").
prompt	string	Required	Scene description.
mode	string	Optional	"text" (default), "image" (animate a first-frame image), "reference" (style transfer from one or more frames).
duration_seconds	integer	Optional	Clip length. Range depends on the model — typically 5, 8 or 10 s. Defaults to the model's minimum.
aspect_ratio	string	Optional	"16:9", "9:16", "1:1", "4:3" — must be in the model's supported list.
quality	string	Optional	"480p", "720p", "1080p" — must be in the model's supported list.
input_images	array	Optional	[{ url? } \| { b64_json? }] — required for "image" and "reference" modes.
seed	integer	Optional	Reproducibility seed where supported.
sound	boolean	Optional	Enable native audio track on models that produce sound (e.g. wan).

Örnekler

Metinden videoya

curl https://api.airforce/v1/video/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.6",
    "prompt": "A red fox darting across snowy hills at dawn",
    "duration_seconds": 8,
    "aspect_ratio": "16:9",
    "quality": "720p",
    "sound": true
  }'

Görüntüden videoya (ilk kare)

curl https://api.airforce/v1/video/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-1",
    "mode": "image",
    "prompt": "Camera pulls back as the dragon takes off",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "input_images": [{"url": "https://example.com/dragon.jpg"}]
  }'

Cevap

Parameter	Type	Required	Description
task_id	string	Optional	Persistent task identifier. Use it on every follow-up endpoint.
status	string	Optional	"queued" right after creation.
model	string	Optional	Echo of requested model.
created	integer	Optional	Unix timestamp.
expires_at	integer	Optional	Unix timestamp after which the result is purged (typically created + 86400).
cost_cents	number	Optional	Up-front cost debited from your balance. Refunded if the task ultimately fails.

{
  "task_id": "vid_01HXY1234ABCD",
  "status": "queued",
  "model": "wan-2.6",
  "created": 1715000000,
  "expires_at": 1715086400,
  "cost_cents": 320
}

2. Durum için anket yapın

Her 5-15 saniyede bir anket yapın. Görevler süreye ve modele bağlı olarak genellikle 30 saniye – 4 dakika içinde tamamlanır. Aynı uç nokta, durum "tamamlandı" durumuna döndüğünde sonuç URL'sini döndürür.

GEThttps://api.airforce/v1/video/tasks/:task_id

Parameter	Type	Required	Description
status	string	Optional	"queued" \| "running" \| "completed" \| "failed" \| "expired".
progress	integer	Optional	0–100 while running. Absent for queued tasks.
result_url	string	Optional	MP4 download URL once status is "completed". Pre-signed; valid until expires_at.
thumbnail_url	string	Optional	Optional poster frame.
error	object	Optional	Set when status is "failed". { type, message }.
cost_cents	number	Optional	Final cost. Equals the create-time cost on success.

{
  "task_id": "vid_01HXY1234ABCD",
  "status": "completed",
  "progress": 100,
  "result_url": "https://cdn.api.airforce/video/vid_01HXY1234ABCD.mp4",
  "thumbnail_url": "https://cdn.api.airforce/video/vid_01HXY1234ABCD.jpg",
  "model": "wan-2.6",
  "duration_seconds": 8,
  "expires_at": 1715086400,
  "cost_cents": 320
}

2b. Akış ilerlemesi (isteğe bağlı)

Sunucu Tarafından Gönderilen Olaylar akışıyla yoklama döngüsünü atlayın. Her ilerleme değişikliğinde bir olay yayar ve görev terminal durumuna geçtiğinde kapanır. GET uç noktasıyla aynı yük şekli.

GEThttps://api.airforce/v1/video/tasks/:task_id/stream

event: progress
data: {"task_id":"vid_01HXY...","status":"running","progress":12}

event: progress
data: {"task_id":"vid_01HXY...","status":"running","progress":58}

event: completed
data: {"task_id":"vid_01HXY...","status":"completed","progress":100,"result_url":"https://cdn.api.airforce/video/vid_01HXY....mp4"}

3. Listeleyin ve silin

GEThttps://api.airforce/v1/video/tasks

En son görevlerinizi döndürür (önce en yenisi). Kontrol panelinin geçmiş görünümü oluşturması açısından kullanışlıdır.

Parameter	Type	Required	Description
limit	integer	Optional	Max items returned. Default 50, max 200. Pass as a query string.
status	string	Optional	Filter to one status, e.g. ?status=running.

curl "https://api.airforce/v1/video/tasks?limit=20&status=completed" \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY"

DELETEhttps://api.airforce/v1/video/tasks/:task_id

Görevi geçmişinizden kaldırır. MP4 ayrıca CDN deposundan da silinir. Geri ödeme yok; maliyet zaten borçlandırıldı.

Maliyet ve kısıtlamalar

Her video modeli, okuyabileceğiniz yetenek meta verilerini ortaya çıkarır /v1/models:

Parameter	Type	Required	Description
video_caps.aspect_ratios	array	Optional	Allowed aspect_ratio values.
video_caps.qualities	array	Optional	Allowed quality values.
video_caps.min_duration_s / max_duration_s	integer	Optional	Allowed range for duration_seconds.
video_caps.modes	array	Optional	Subset of ["text", "image", "reference"] supported.
video_caps.price_per_second_cents	integer	Optional	Cost = duration_seconds × this value.

Cost is debited at task creation. Failed tasks (status "failed" or "expired") refund the cost.
Max 4 concurrent video tasks per API key.
Result URLs are pre-signed and stop working at expires_at. Download or copy the MP4 to your own storage if you need it longer.

Uçtan uca komut dosyası

async function generateVideo(prompt) {
  const create = await fetch('https://api.airforce/v1/video/generations', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'wan-2.6',
      prompt,
      duration_seconds: 8,
      aspect_ratio: '16:9',
      quality: '720p',
    }),
  }).then(r => r.json());

  const { task_id } = create;

  // Poll until done.
  while (true) {
    await new Promise(r => setTimeout(r, 8_000));
    const task = await fetch(
      `https://api.airforce/v1/video/tasks/${task_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } },
    ).then(r => r.json());

    if (task.status === 'completed') return task.result_url;
    if (task.status === 'failed' || task.status === 'expired') {
      throw new Error(task.error?.message ?? task.status);
    }
  }
}