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

Генерация видео по API

Генерация видео по API снимает ролик по текстовому описанию на нейросетях Студии «Весело»: Seedance 2.5, Kling 4.0, Wan 3.0, MiniMax H3 и других. Отправляешь сцену и получаешь задачу, а через несколько минут забираешь готовый MP4. Цена — за ролик, по длине и качеству, в рублях. Если ролик не получился, деньги вернутся на API-счёт.

  • 10 моделей
  • от 29 ₽ за ролик
  • 4 вендора

Обновлено:

Получить ключ Документация

Модели и цены

Видео: цена в рублях за ролик
МодельВендорДлинаЦена
Seedance 2.5ByteDance5–30 сот 89 ₽ за ролик
Kling 4.0Kling (Kuaishou)5–30 сот 129 ₽ за ролик
MiniMax H3MiniMax5–15 сот 69 ₽ за ролик
Wan 3.0Alibaba5–30 сот 39 ₽ за ролик
Seedance 2.0ByteDance5–15 сот 59 ₽ за ролик
Wan 3.0 PrimeAlibaba5–30 сот 59 ₽ за ролик
Wan 2.7Alibaba5–15 сот 79 ₽ за ролик
Seedance 2.0 FastByteDance5–15 сот 49 ₽ за ролик
Seedance 2.0 MiniByteDance5–15 сот 29 ₽ за ролик
Wan 2.6Alibaba5–10 сот 79 ₽ за ролик

Как выбрать

Видео по API — это задача, а не мгновенный ответ. POST /v1/videos с полями model, prompt, duration, resolution, aspect_ratio и audio возвращает id, а дальше программа раз в 10–15 секунд спрашивает GET /v1/videos/{id}, пока статус не станет completed. Обычно на это уходит от пары минут до десяти, как раз чтобы заварить чай. Готовый ролик приходит ссылкой на MP4 и обложку и появляется в «Моих видео» на сайте.

Через API ролик снимается только по описанию: свои фото и видео-образцы принимает Студия. Описание проверяется по тем же правилам, что в Студии, и запрещённая сцена отклоняется до списания.

Длина. До 30 секунд одним роликом снимают Seedance 2.5, Wan 3.0, Wan 3.0 Prime и Kling 4.0. До 15 секунд — Seedance 2.0 с версиями Fast и Mini, Wan 2.7 и MiniMax H3. Wan 2.6 снимает 5 или 10 секунд.

Звук. Seedance, Wan и MiniMax H3 сразу добавляют звук сцены: шаги, шум, эффекты. Поле audio по умолчанию включено, а "audio": false даст ролик без звука. Kling 4.0 у нас снимает без звука всегда.

Качество и кадр. 1080p есть у Seedance 2.5 и 2.0, у Wan 3.0, 3.0 Prime, 2.7 и 2.6 и у Kling 4.0. MiniMax H3 снимает в 768p или 2K, Seedance 2.0 Fast и Mini — в 480p или 720p. Кадр по умолчанию вертикальный, 9:16, можно выбрать 16:9, 1:1, 4:3 или 3:4, а у Seedance и MiniMax H3 есть ещё широкий 21:9.

Движение. У Seedance 2.5 естественно двигаются люди, и она держит сюжет из нескольких действий подряд; ByteDance описывает её как модель, которая создаёт картинку и звук вместе, до 30 секунд за одну генерацию. Kling 4.0 сильна плавными пролётами камеры и физикой воды, ткани и волос. Wan 3.0 из короткой фразы сама додумывает сцену и хорошо понимает русский.

Скорость. В Студии Wan 3.0, Seedance 2.0 Fast и Mini снимают ролик примерно за 2 минуты, Seedance 2.5 — примерно за 7. Черновик удобно снять на быстрой модели, а удачную сцену переснять на Seedance 2.5.

Что сейчас недоступно. Kling 3.0, 3.0 Turbo, 3.0 Omni, O1, 2.6 и 2.5 Turbo стоят на паузе: заказать их сейчас нельзя ни по API, ни в Студии, а запрос к ним вернёт ошибку без списания. Sora 2 и Veo по API у нас нет, об этом — в вопросах ниже.

Что под какую задачу:

Популярные задачи

Ролики для соцсетей потоком

Контент-план на месяц — это тридцать сцен, и снимать их по одной руками долго. Программа берёт описания из таблицы, ставит задачи в очередь и забирает готовые MP4. Черновики удобно снимать на Wan 3.0 в 9:16, а сцены, которые пойдут в ленту, — на Seedance 2.5. Каждой сцене дай свой Idempotency-Key, например номер строки таблицы: повтор после обрыва связи вернёт тот же ролик без второго списания.

Пример запроса: «Утро в маленькой пекарне: пекарь достаёт из печи румяные круассаны, пар поднимается над противнем, камера медленно наезжает».

Рекламные креативы для тестов

Один оффер — пять разных сцен: кофе в руках у бегуна, тот же кофе на подоконнике в дождь, на столе в офисе. Seedance 2.0 Fast снимает такие варианты быстро и сразу со звуком, а сцену, которая выиграла тест, переснимай на Seedance 2.5 в 1080p. Как писать описания сцен, разобрано в статье промты для видео.

Пример запроса: «Девушка в спортивной куртке бежит по набережной на рассвете, на бегу делает глоток кофе из стакана, камера едет рядом».

Видео для карточек товаров и лендингов

По API ролик снимается без твоих фото, поэтому для карточки он годится как атмосфера: шёлк падает на стол, капли стекают по стеклу, пар поднимается над чашкой. Здесь к месту Kling 4.0 с её физикой ткани и воды. Чтобы в кадре был именно твой товар, нужен его снимок, а это уже Студия; как это сделать, рассказали в статье видео для карточки товара.

Пример запроса: «Шёлковый платок медленно падает на мраморный стол, мягкий боковой свет, крупный план, замедленная съёмка».

Фоновое видео для сайта или приложения

Первому экрану сайта нужен спокойный ролик без звука: пролёт над городом, волны, облака. Ставь aspect_ratio: "16:9", а модель бери с хорошей камерой — Kling 4.0 или Wan 3.0 Prime с "audio": false. Файл скачай к себе: ссылка на результат живёт ограниченное время.

Пример запроса: «Дрон медленно пролетает над ночным городом, огни проспектов, лёгкий туман, без людей в кадре».

Сюжет из нескольких действий

Seedance 2.5 держит порядок действий, если разложить сюжет по кадрам. Так ролик не превращается в кашу из всего сразу. Для целого фильма из многих сцен есть Studio Professional: там идея раскладывается на сцены, а снятые сцены собираются в один фильм.

Пример запроса: «Кадр 1: девушка открывает дверь кафе. Кадр 2: камера проезжает за ней к стойке. Кадр 3: она улыбается бариста».

Видео в ответ пользователю бота

Бот получает от человека описание, ставит задачу и, пока ролик снимается, показывает проценты из поля progress и примерное время из eta_seconds. Когда статус станет completed, бот отправляет файл по ссылке result.url, она открывается без ключа. Если пришёл failed, у задачи будет refunded: true: деньги уже вернулись на API-счёт.

Пример запроса: «Снеговик в шарфе катается на коньках по замёрзшему пруду, вокруг ёлки в снегу, вечер».

Как подключить

Вместо sk-vsl-ТВОЙ_КЛЮЧ — ключ из кабинета. Пример — с моделью Seedance 2.5: у других моделей меняется только model.

curl

# запустить: в ответе id задачи, например video_123
curl https://veselo.ai/v1/videos \
  -H "Authorization: Bearer sk-vsl-ТВОЙ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: scene-001" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "prompt": "Кот в солнечных очках катается на скейте по набережной на закате"
  }'

# статус и ссылка на готовый ролик
curl https://veselo.ai/v1/videos/video_123 \
  -H "Authorization: Bearer sk-vsl-ТВОЙ_КЛЮЧ"

Python

import time, requests  # pip install requests

API = "https://veselo.ai/v1"
headers = {"Authorization": "Bearer sk-vsl-ТВОЙ_КЛЮЧ"}

r = requests.post(f"{API}/videos", headers={**headers, "Idempotency-Key": "scene-001"}, json={
    "model": "bytedance/seedance-2.5",
    "prompt": "Кот в солнечных очках катается на скейте по набережной на закате",
}, timeout=120)
r.raise_for_status()
v = r.json()
while v["status"] in ("queued", "in_progress"):
    time.sleep(10)
    v = requests.get(f"{API}/videos/{v['id']}", headers=headers, timeout=30).json()
print(v["result"]["url"] if v["status"] == "completed" else v["error"]["message"])

JavaScript

const API = 'https://veselo.ai/v1';
const headers = { Authorization: 'Bearer sk-vsl-ТВОЙ_КЛЮЧ', 'Content-Type': 'application/json' };

const res = await fetch(`${API}/videos`, {
  method: 'POST',
  headers: { ...headers, 'Idempotency-Key': 'scene-001' },
  body: JSON.stringify({ model: 'bytedance/seedance-2.5', prompt: 'Кот в солнечных очках катается на скейте по набережной на закате' }),
});
let v = await res.json();
if (!res.ok) throw new Error(v.error.message);
while (v.status === 'queued' || v.status === 'in_progress') {
  await new Promise((r) => setTimeout(r, 10_000));
  v = await (await fetch(`${API}/videos/${v.id}`, { headers })).json();
}
console.log(v.status === 'completed' ? v.result.url : v.error.message);

В программах: тем же ключом — из любого кода, а без ключа Claude, ChatGPT и Cursor зовут модель по MCP: вход на сайте и кнопка «Разрешить». MCP

Seedance 2.5 · Документация раздела

Вопросы и ответы

Сколько ждать готовое видео?
От пары минут до десяти: короткий ролик на Wan 3.0 приходит быстрее, длинный на Seedance 2.5 снимается дольше. Статус спрашивай раз в 10–15 секунд, чаще смысла нет.
Можно ли приложить своё фото или видео-образец?
Через API — нет, только описание сцены. Со своими файлами работает Студия: у Seedance и Wan 3.0 там до четырёх фото-образцов или одно фото первым кадром, а ещё видео-образец до 15 секунд.
Что будет, если ролик не получится?
Статус станет failed, в error.message будет причина своими словами, а refunded: true значит, что удержанные деньги вернулись на API-счёт. Описание, которое не прошло проверку, отклоняется ещё до запуска, и за него ничего не списывается.
Как не заплатить дважды, если запрос оборвался?
Передавай заголовок Idempotency-Key. Повтор с тем же ключом и тем же телом вернёт уже созданный ролик и второй раз ничего не спишет. Тот же ключ с другим телом вернёт ошибку 409, так программа не перепутает две разные сцены.
Есть ли у вас Sora 2 и Veo по API?
Нет. OpenAI выключила sora-2 24 сентября 2026 года и прямой замены не назвала, так написано на её странице устаревших моделей. Veo в нашем каталоге нет. Ближе всего к ним по задаче Seedance 2.5: до 30 секунд одним роликом и сразу со звуком. Подробнее — в статье Sora 2 и Veo 3 в России.
Сколько хранится готовый ролик?
Ссылка result.url открывается без ключа, а сколько дней хранится файл, написано в поле result.expires_in_days. Скачай ролик к себе заранее: после этого срока файла не будет.
Можно ли снимать видео из Claude или ChatGPT?
Да. Подключи «Весело» по MCP на странице подключения, и у программы появятся инструменты, чтобы запустить ролик и узнать, готов ли он. Деньги списываются с того же API-счёта.
Нужны ли VPN и зарубежная карта?
Нет. Запросы идут на https://veselo.ai/v1, а API-счёт пополняется в рублях — картой российского банка или по СБП.
Сколько стоит запрос, который закончился ошибкой?
Нисколько: ошибка нейросети денег не стоит, удержание на время запроса снимается целиком.

Ещё по теме

Факты сверены 16 ноября 2026 по документации: seed.bytedance.com, developers.openai.com