Video

1. Crea una tarea

Envía el trabajo y devuelve un task ID. El coste se estima a partir de duración × precio por segundo del modelo y se liquida cuando se procesa el trabajo.

Cualquier otra clave (p. ej. seed, sound) se reenvía al proveedor upstream tal cual — no se valida aquí y el soporte depende del modelo.

Ejemplos

Texto a vídeo

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

Imagen a vídeo (primer fotograma)

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

Respuesta

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

2. Encuesta de estado

Encuesta cada 5 a 15 segundos. Las tareas suelen completarse en 30 s – 4 min, según la duración y el modelo. El mismo punto final devuelve la URL del resultado cuando el estado cambia a "completado".

{
  "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. Progreso de la transmisión (opcional)

Evite el ciclo de sondeo con una transmisión de eventos enviados por el servidor. Emite un evento por cambio de progreso y se cierra una vez que la tarea está en un estado terminal. Misma forma de carga útil que el punto final 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. Listar y eliminar

Devuelve tus tareas recientes (las más recientes primero). Útil para que el panel muestre una vista del historial.

Devuelve hasta tus 100 tasks más recientes, las más nuevas primero, como { "data": [ ...tasks ] }. No hay parámetros de consulta — filtra y pagina del lado del cliente.

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

Elimina el registro de la tarea de tu historial.

Idempotente — siempre devuelve { "deleted": true }. Esto elimina únicamente tu registro de historial; no purga por separado la media almacenada.

Costo y limitaciones

Cada modelo de vídeo expone metadatos de capacidad que puede leer /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);
    }
  }
}