Video

1. Crea un'attività

Invia il job e restituisce un task ID. Il costo è stimato da durata × prezzo al secondo del modello e addebitato quando il job viene elaborato.

Qualsiasi altra chiave (es. seed, sound) viene inoltrata al provider upstream così com'è — non viene validata qui e il supporto dipende dal modello.

Esempi

Da testo a video

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
  }'

Da immagine a video (primo fotogramma)

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"}]
  }'

Risposta

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

2. Sondaggio per lo stato

Sondaggio ogni 5-15 secondi. Le attività vengono solitamente completate in 30 secondi – 4 minuti a seconda della durata e del modello. Lo stesso endpoint restituisce l'URL del risultato quando lo stato passa a "completato".

{
  "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. Avanzamento dello streaming (facoltativo)

Salta il ciclo di polling con un flusso di eventi inviati dal server. Emette un evento per ogni modifica di avanzamento e si chiude una volta che l'attività è in uno stato terminale. Stessa forma del carico utile dell'endpoint GET.

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. Elenca ed elimina

Restituisce le attività recenti (prima la più recente). Utile per il dashboard per eseguire il rendering di una visualizzazione della cronologia.

Restituisce fino ai tuoi 100 task più recenti, dal più nuovo, come { "data": [ ...tasks ] }. Non ci sono parametri di query — filtra e pagina lato client.

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

Rimuove il record dell’attività dalla cronologia.

Idempotente — restituisce sempre { "deleted": true }. Questo elimina solo il tuo record nella cronologia; non elimina separatamente i media memorizzati.

Costi e vincoli

Ogni modello video espone metadati di funzionalità da cui è possibile leggere /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);
    }
  }
}