Видео
Открыть .md

Видео

POST /v1/videos — асинхронная генерация видео: создать задачу, опрашивать статус, скачать ролик.

Видео генерируется асинхронно: вы ставите задачу, опрашиваете её статус и скачиваете готовый ролик. Работает только с моделями видео из каталога; в примерах ниже подставьте их ID вместо VIDEO_MODEL_ID.

1. Создать задачу

bash
curl https://ai-seller.vibe-codes.ru/v1/videos \
  -H "Authorization: Bearer $AISELLER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "VIDEO_MODEL_ID",
    "prompt": "Волны разбиваются о маяк на закате",
    "seconds": 8
  }'

Ответ — 202 с объектом задачи:

json
{"id": "vid_...", "object": "video", "model": "VIDEO_MODEL_ID", "status": "queued", "progress": 0, "created_at": 1790000000}

2. Опрашивать статус

bash
curl https://ai-seller.vibe-codes.ru/v1/videos/vid_... \
  -H "Authorization: Bearer $AISELLER_API_KEY"

Опрашивайте раз в несколько секунд, пока status не станет completed или failed. Промежуточные статусы — queued и in_progress.

json
{"id": "vid_...", "object": "video", "status": "completed", "seconds": "8", "data": [{"url": "https://.../v1/videos/vid_.../content"}]}

У проваленной задачи status: "failed" и error.code: "video_generation_failed"; списания за неё нет.

3. Скачать видео

Ссылка из data[0].url ведёт на GET /v1/videos/{id}/content. Скачивайте с тем же ключом:

bash
curl -L https://ai-seller.vibe-codes.ru/v1/videos/vid_.../content \
  -H "Authorization: Bearer $AISELLER_API_KEY" \
  -o video.mp4

До готовности этот адрес отвечает 404 not_found.

Особенности

  • Списание — за длительность ролика в секундах из ответа провайдера (если он её не назвал — за запрошенные секунды), один раз, когда задача завершилась. Резерв баланса на время генерации не ставится.
  • Параметры: prompt, seconds (или duration, duration_seconds), size, aspect_ratio, resolution, negative_prompt, seed; референсы — image, images, video, input_reference. Лимит тела запроса — 70 МиБ.
  • Задача видна только ключам вашего аккаунта; чужой id отвечает 404 not_found.
  • Ограничение одновременных запросов на видео-задачи не распространяется.

Обновлено 29 сентября 2026 г.