Видео

1. Создайте задачу

Отправляет задачу и возвращает task ID. Стоимость оценивается как длительность × цена за секунду модели и списывается при обработке задачи.

Любые другие ключи (например, seed, sound) передаются вышестоящему провайдеру как есть — здесь они не валидируются, и их поддержка зависит от модели.

Примеры

Преобразование текста в видео

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

Преобразование изображения в видео (первый кадр)

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

Ответ

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

2. Опрос на статус

Опрос каждые 5–15 секунд. Задачи обычно выполняются за 30–4 минуты в зависимости от продолжительности и модели. Та же конечная точка возвращает URL-адрес результата, когда статус меняется на «завершено».

{
  "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
}

2б. Прогресс трансляции (необязательно)

Пропустите цикл опроса с помощью потока событий, отправленных сервером. Выдает одно событие при каждом изменении хода выполнения и закрывается, когда задача переходит в терминальное состояние. Та же форма полезных данных, что и у конечной точки 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. Перечислить и удалить

Возвращает ваши недавние задачи (сначала самые новые). Полезно для информационной панели для отображения истории.

Возвращает до 100 ваших самых недавних task'ов, сначала новые, в виде { "data": [ ...tasks ] }. Query-параметры отсутствуют — фильтруйте и разбивайте на страницы на стороне клиента.

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

Удаляет запись задачи из вашей истории.

Идемпотентно — всегда возвращает { "deleted": true }. Это удаляет только запись из вашей истории; хранимые media отдельно не очищаются.

Стоимость и ограничения

Каждая видеомодель предоставляет метаданные возможностей, которые вы можете прочитать. /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);
    }
  }
}