Видео
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 г.