Vidéo

1. Créez une tâche

Soumet la tâche et renvoie un task ID. Le coût est estimé à partir de durée × prix par seconde du modèle et réglé lorsque la tâche est traitée.

Toute autre clé (p. ex. seed, sound) est transmise telle quelle au fournisseur en amont — elle n'est pas validée ici et la prise en charge dépend du modèle.

Exemples

Texte vers vidéo

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

Image vers vidéo (première image)

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

Réponse

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

2. Sondage pour le statut

Sondez toutes les 5 à 15 secondes. Les tâches sont généralement terminées en 30 s à 4 minutes selon la durée et le modèle. Le même point de terminaison renvoie l'URL du résultat lorsque le statut passe à « terminé ».

{
  "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. Progression du flux (facultatif)

Évitez la boucle d'interrogation avec un flux d'événements envoyés par le serveur. Émet un événement par changement de progression et se ferme une fois que la tâche est dans un état terminal. Même forme de charge utile que le point de terminaison 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. Liste et suppression

Renvoie vos tâches récentes (les plus récentes en premier). Utile pour que le tableau de bord affiche une vue historique.

Renvoie jusqu'à vos 100 tâches les plus récentes, les plus récentes en premier, sous la forme { "data": [ ...tasks ] }. Il n'y a aucun paramètre de requête — filtrez et paginez côté client.

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

Supprime l’enregistrement de la tâche de votre historique.

Idempotent — renvoie toujours { "deleted": true }. Cela supprime uniquement votre enregistrement d'historique ; cela ne purge pas séparément les médias stockés.

Coût & contraintes

Chaque modèle vidéo expose des métadonnées de capacité que vous pouvez lire /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);
    }
  }
}