Весело
Весело

Видео по API: Seedance, Wan, Kling и MiniMax за рубли

Как снять видео нейросетью по API: Seedance, Wan, Kling и MiniMax — задача, статус, ссылка на ролик. Оплата в рублях, возврат при сбое.

Обновлено:

Видео снимается дольше, чем отвечает чат: от пары минут до десяти. Поэтому это задача: отправляешь описание сцены — получаешь id, потом спрашиваешь статус, пока ролик не будет готов. Снимает та же очередь, что и Студия на сайте: если нейросеть не ответила, задача сама уходит к запасному поставщику.

Видеомодели и цена за ролик — в рублях
idМодельЦена
bytedance/seedance-2.5Seedance 2.5от 89 ₽ за ролик
bytedance/seedance-2.0Seedance 2.0от 59 ₽ за ролик
bytedance/seedance-2.0-fastSeedance 2.0 Fastот 49 ₽ за ролик
bytedance/seedance-2.0-miniSeedance 2.0 Miniот 29 ₽ за ролик
alibaba/wan-3.0Wan 3.0от 39 ₽ за ролик
alibaba/wan-3.0-primeWan 3.0 Primeот 59 ₽ за ролик
alibaba/wan-2.7Wan 2.7от 79 ₽ за ролик
alibaba/wan-2.6Wan 2.6от 79 ₽ за ролик

У видеомоделей в GET /v1/models поле type: "video". Цена за ролик — pricing_rub.per_video["720p"]["10"] (качество и длина в секундах), что можно выбрать — поле video: длины, качество, кадр, есть ли звук.

Запустить ролик

curl

curl https://veselo.ai/v1/videos \
  -H "Authorization: Bearer $VESELO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: scene-001" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Кот в солнечных очках катается на скейте по набережной на закате",
    "duration": 5,
    "resolution": "480p",
    "aspect_ratio": "9:16"
  }'

Python

import os, requests

r = requests.post(
    "https://veselo.ai/v1/videos",
    headers={
        "Authorization": f"Bearer {os.environ['VESELO_API_KEY']}",
        "Idempotency-Key": "scene-001",
    },
    json={
        "model": "alibaba/wan-3.0",
        "prompt": "Кот в солнечных очках катается на скейте по набережной на закате",
        "duration": 5,
        "resolution": "480p",
        "aspect_ratio": "9:16",
    },
    timeout=120,
)
r.raise_for_status()
video = r.json()
print(video["id"], video["price_rub"], "₽")

JavaScript

const res = await fetch('https://veselo.ai/v1/videos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.VESELO_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'scene-001',
  },
  body: JSON.stringify({
    model: 'alibaba/wan-3.0',
    prompt: 'Кот в солнечных очках катается на скейте по набережной на закате',
    duration: 5,
    resolution: '480p',
    aspect_ratio: '9:16',
  }),
});
const video = await res.json();
console.log(video.id, video.price_rub, '₽');
ПолеЧто это
modelобязательно: id видеомодели из GET /v1/models, например alibaba/wan-3.0
promptобязательно: описание сцены, от 3 до 4000 знаков — кто в кадре, что делает, где, как движется камера
durationдлина в секундах — из video.durations модели; по умолчанию самая короткая
resolutionкачество — из video.resolutions; по умолчанию самое дешёвое
aspect_ratioкадр — из video.aspect_ratios, по умолчанию 9:16
audioсо звуком, если модель умеет; по умолчанию true

Ответ — 202 с задачей: id вида video_123, status, price_rub — сколько списано, и выбранные duration, resolution, aspect_ratio.

Узнать статус

GET https://veselo.ai/v1/videos/{id} — тем же ключом или любым ключом того же аккаунта. Спрашивай раз в 10–15 секунд: чаще ролик готов не будет.

Python

import os, time, requests

headers = {"Authorization": f"Bearer {os.environ['VESELO_API_KEY']}"}
video_id = "video_123"  # id из ответа на запуск

while True:
    v = requests.get(f"https://veselo.ai/v1/videos/{video_id}", headers=headers, timeout=30).json()
    if v["status"] == "completed":
        print("Готово:", v["result"]["url"])
        break
    if v["status"] == "failed":
        print("Не получилось:", v["error"]["message"], "— деньги вернули:", v["refunded"])
        break
    print(v["status"], v["progress"], "%", v["stage"])
    time.sleep(10)

JavaScript

const headers = { Authorization: `Bearer ${process.env.VESELO_API_KEY}` };
const videoId = 'video_123'; // id из ответа на запуск

for (;;) {
  const v = await (await fetch(`https://veselo.ai/v1/videos/${videoId}`, { headers })).json();
  if (v.status === 'completed') { console.log('Готово:', v.result.url); break; }
  if (v.status === 'failed') { console.log('Не получилось:', v.error.message, 'возврат:', v.refunded); break; }
  console.log(v.status, v.progress, '%', v.stage);
  await new Promise((r) => setTimeout(r, 10_000));
}
statusЧто значит
queuedждёт своей очереди
in_progressснимается: progress — проценты, stage — этап словами, eta_seconds — сколько примерно осталось
completedготово: result.url — MP4, result.poster_url — обложка
failedне получилось: error.message — почему, refunded: true — деньги вернулись на баланс

Деньги

  • Цена — за ролик целиком, как в Студии на сайте, и видна заранее в GET /v1/models.
  • Платит API-счёт: при запуске цена удерживается, когда ролик готов — списывается. Не хватает — ошибка 402.
  • Не получилось — удержание снимается, деньги остаются на API-счёте, в ответе refunded: true.
  • Повтор запроса с тем же Idempotency-Key и тем же телом вернёт тот же ролик без второго списания. Тот же ключ с другим телом — 409 idempotency_conflict. Без заголовка каждый запрос — новый ролик.

Готовый ролик

Ссылка result.url открывается без ключа. Файлы хранятся ограниченное время — result.expires_in_days дней, поэтому скачай ролик к себе. Ролик появится и в «Моих видео» на сайте; уведомления в Telegram и на почту для роликов из API не приходят.

Ограничения

  • Одновременно снимается до 3 роликов на аккаунт — вместе с роликами на сайте. Больше — 429 rate_limited.
  • Описание сцены проверяется так же, как в Студии. Не прошло — 422 content_refused, деньги не списаны.
  • Пока только текст: свои фото и видео к описанию через API не принимаются.

← Картинки · Озвучка →

Вся документация одним текстом · Все модели и цены