Генерация видео через API: полный пример

Три шага: создать, дождаться, скачать

1. POST /v1/videos — создаёт задачу, возвращает её id;
2. GET /v1/videos/{id} — показывает статус (queued, in_progress, completed, failed);
3. GET /v1/videos/{id}/content — отдаёт готовый файл.

import time, requests

H = {"Authorization": "Bearer ВАШ_КЛЮЧ"}
job = requests.post("https://api.velourapi.ru/v1/videos", headers=H, json={
    "model": "seedance-2.0",
    "prompt": "Бордовый бархат медленно колышется в тёплом контровом свете",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "9:16",
}).json()

while True:
    state = requests.get(f"https://api.velourapi.ru/v1/videos/{job['id']}", headers=H).json()
    if state["status"] == "completed":
        break
    if state["status"] == "failed":
        raise SystemExit(state)
    time.sleep(5)

open("clip.mp4", "wb").write(requests.get(f"https://api.velourapi.ru/v1/videos/{job['id']}/content", headers=H).content)

Какие параметры можно задавать

• seconds — длительность. У каждой модели свой набор значений: у одних 5, 10 и 15 секунд, у других до 30;
• resolution — например 480p, 720p, 1080p;
• aspect_ratio — 9:16 для вертикальных роликов, 16:9 для горизонтальных, 1:1 для квадрата;
• audio — включает звук у моделей, которые его умеют;
• image — ссылка на картинку, с которой начнётся видео.

Если параметр недопустим, API вернёт понятную ошибку со списком возможных значений ещё до списания денег.

Сколько ждать и сколько платить

Время зависит от модели и длительности: быстрые версии отвечают в пределах минуты-двух, флагманы могут работать заметно дольше. Цена считается по параметрам: чем дольше ролик и выше разрешение, тем она больше. Примеры:

* Цены ориентировочные: рассчитаны по таблице стоимости с нашей наценкой. Точную сумму вы видите в каталоге моделей и в подборе по задаче до запуска.

Советы

• Сначала пробуйте дешёвую модель в низком разрешении — так проверяется идея за копейки;
• Описывайте сцену конкретно: объект, действие, камера, свет;
• Скачивайте результат сразу: ссылки на файлы временные;
• Не хотите писать код? Опишите задачу агенту — он выберет модель, назовёт цену и сделает всё сам.