Video

1. Bir görev oluşturun

İşi gönderir ve bir task ID döndürür. Maliyet, süre × modelin saniye başına fiyatından tahmin edilir ve iş işlendiğinde tahsil edilir.

Diğer tüm anahtarlar (örn. seed, sound) üst akış sağlayıcısına olduğu gibi iletilir — burada doğrulanmazlar ve destek modele bağlıdır.

Ö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

{
  "task_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "queued",
  "model": "wan-2.6",
  "created": 1715000000,
  "expires_at": 1715086400,
  "progress": 0,
  "cost_cents": 320
}

2. Durumu sorgulayın

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

{
  "task_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "completed",
  "progress": 100,
  "result_url": "https://.../video.mp4",
  "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.

event: state
data: {"task_id":"f47ac10b-...","status":"processing","progress":12}

event: state
data: {"task_id":"f47ac10b-...","status":"processing","progress":58}

event: state
data: {"task_id":"f47ac10b-...","status":"completed","progress":100,"result_url":"https://.../video.mp4"}

event: done
data: [DONE]

3. Listeleyin ve silin

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.

En son 100 task'ınıza kadarını, en yenisi önce olacak şekilde { "data": [ ...tasks ] } biçiminde döndürür. Sorgu parametresi yoktur — istemci tarafında filtreleyin ve sayfalayın.

curl https://api.airforce/v1/video/tasks \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY"

Görev kaydını geçmişinizden kaldırır.

Idempotent — her zaman { "deleted": true } döndürür. Bu yalnızca geçmiş kaydınızı siler; depolanan media'yı ayrıca temizlemez.

Maliyet ve kısıtlamalar

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

• Cost is estimated at creation and settled when the job is processed; failed or expired tasks are not charged.
• 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.

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 ?? task.status);
    }
  }
}