API генерации видео в России
Нейросети делают ролик по описанию, из готовой картинки и по образцу — по одному ключу и с оплатой рублями. Записей в каталоге 18, страниц у них 9: режимы и уровни одной модели показаны вместе. Раздел документации разбирает вызов целиком.
Цены на генерацию видео
Цена за ролик, по самому дешёвому варианту каждой модели.
| Модель | Поставщик | Цена от, за секунду | Скидка | Официальная |
|---|---|---|---|---|
| Seedance 2.0 | ByteDance | $0.0393,9 ₽ | −10% | $0.0433 |
| Kling 3.0 | Kuaishou | $0.07567,56 ₽ | −10% | $0.084 |
| MiniMax H3 | MiniMax | $0.0525,2 ₽ | −35% | $0.08 |
| Wan 2.7 | Alibaba | $0.099 ₽ | −10% | $0.1 |
| Seedance 2.5 | ByteDance | $0.119111,91 ₽ | −10% | $0.1323 |
| Kling 3.0 Motion Control | Kuaishou | $0.113411,34 ₽ | −10% | $0.126 |
| Gemini Omni 1.1 Flash | $0.4141 ₽ | — | — | |
| Kling O3 | Kling | $0.0919,1 ₽ | — | — |
| Wan 3.0 Video | Alibaba | $0.0454,5 ₽ | −10% | $0.05 |
| Veo 3.1 | $0.0454,5 ₽ | −10% | $0.05 |
Бренды видеомоделей
Видеомодели витрины сделаны компаниями: ByteDance, Kuaishou, Google, Kling, MiniMax, Alibaba.
Какие нейросети генерируют видео по API
Видео по API генерируют Seedance 2.0, Kling 3.0, MiniMax H3, Wan 2.7, Seedance 2.5, Kling 3.0 Motion Control, Gemini Omni 1.1 Flash, Kling O3 и Wan 3.0 Video. Сделаны они ByteDance, Kuaishou, Google, Kling, MiniMax и Alibaba. Страниц на витрине 9, а записей каталога за ними 18: уровни и режимы одной модели живут на общем адресе и переключаются кнопками наверху страницы.
Набор работ у страниц разный: Seedance 2.0 — видео из текста, видео из изображения и видео по образцам; Kling 3.0 — видео из текста и видео из изображения; MiniMax H3 — видео из текста, видео из изображения и видео по образцам; Wan 2.7 — видео из текста, видео из изображения, видео по образцам и правка видео; Seedance 2.5 — видео из текста, видео из изображения и видео по образцам; Kling 3.0 Motion Control — перенос движения; Gemini Omni 1.1 Flash — видео из текста и видео из изображения; Kling O3 — видео из текста; Wan 3.0 Video — видео из текста. Одно имя модели закрывает то одну работу, то несколько — у Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini, Kling 3.0 и Gemini Omni 1.1 Flash все свои работы принимает один и тот же идентификатор, а у остальных 12 записей под каждую заведено своё имя для поля model.
Расходятся записи и полями запроса. Выбор разрешения у 16 из них стоит в поле resolution, а у Kling 3.0 и Kling 3.0 Motion Control тем же занято поле mode. Описание ограничено по длине, и предел у каждой записи свой — от 2 500 до 30 000 знаков. Проверить запрос с этими полями можно в песочница с готовой формой.
| Страница | Что делает | Что обязательно на входе | Длительность |
|---|---|---|---|
| Seedance 2.0 | видео из текста, видео из изображения и видео по образцам | только описание | от 4 до 15 секунд |
| Kling 3.0 | видео из текста и видео из изображения | только описание или ссылка на картинку | от 3 до 15 секунд |
| MiniMax H3 | видео из текста, видео из изображения и видео по образцам | только описание | от 4 до 15 секунд |
| Wan 2.7 | видео из текста, видео из изображения, видео по образцам и правка видео | только описание или ссылка на ролик | от 2 до 15 секунд |
| Seedance 2.5 | видео из текста, видео из изображения и видео по образцам | только описание | от 4 до 30 секунд |
| Kling 3.0 Motion Control | перенос движения | ссылка на картинку или ссылка на ролик | секунды приносит присланный файл |
| Gemini Omni 1.1 Flash | видео из текста и видео из изображения | только описание | секунды приносит присланный файл |
| Kling O3 | видео из текста | только описание | от 3 до 15 секунд |
| Wan 3.0 Video | видео из текста | только описание | от 2 до 30 секунд |
| Veo 3.1 | видео из текста, видео из первого и последнего кадра и видео по образцам | только описание — картинки на входе необязательны | 4, 6 и 8 секунд |
Выбор начинают не с имени модели, а с того, что уже лежит на входе. Есть одно описание — подойдёт любая запись, которая снимает по тексту; есть кадр или готовый ролик — набор сужается до тех, кто их принимает. Длительность в последнем столбце — это границы поля duration, а у записи без такого поля секунды приносит присланный файл.
Что можно получить: видео по описанию, из картинки и по образцу
Работ у видеокаталога 5: видео из текста, видео из изображения, видео по образцам, перенос движения и правка видео. Проще всех устроено видео из текста: хватает описания в поле prompt, и ни одной из 11 записей, которые эту работу берут, файл на входе не нужен. Чем вызов ролика отличается от вызова картинки, разобрано в разделе «Видео».
Ролик из изображения делают 9 записей, и кадр им передаётся ссылкой. У 8 записей полей под кадр два — на начало ролика и на его конец. По всему видеокаталогу ссылка на картинку обязательна у 2 записей — Kling 3.0 Motion Control и Kling 3.0 Turbo image-to-video; запрос без неё до поставщика не доходит, его отклоняет наш шлюз.
По образцу снимают 6 записей: рядом с описанием кладут списки ссылок — на картинки, на готовые ролики и на звук. Больше всех образцов берут Seedance 2.5 — до 30 картинок одним списком. Остаются ещё две работы, и каждую делает одна запись. Kling 3.0 Motion Control переносит движение: в запрос обязательно идут и картинка, и ролик, а поля duration у неё нет вовсе. Wan 2.7 Video Edit переделывает готовое видео по текстовому указанию, и ссылка на исходный ролик здесь тоже обязательна.
- Свойства ролика задаются полями запроса и от присланного файла не наследуются: длительность берут из duration, а не из длины образца.
- Присланные файлы должны сходиться между собой: кадр по пояс и образец в полный рост роняют задачу раз за разом.
- Часть отказов относится к самому файлу, а не к описанию, и чинится заменой файла, а не переписыванием запроса.
- Формально подходящий по формату ролик иногда всё равно не берётся, и помогает пережать его перед отправкой.
- Пределы входа у каждой записи свои: и длина описания, и размер кадра в точках.
Ссылка на файл должна открываться снаружи: адрес внутри своей сети шлюз отклоняет, к поставщику не обращаясь. Файл с диска сначала превращают в ссылку — как это делается, разобрано в разделе «Загрузка своих файлов».
Сколько стоит генерация видео по API
Платят здесь за длительность: у большинства записей счёт идёт за секунду, и сумма получается умножением ставки на число секунд. Дешевле всего секунда у Seedance 2.0 Mini — 3,9 ₽, дороже всего у Seedance 2.0 — 140,4 ₽; место в этой вилке определяет разрешение. Длительность выбирается полем duration, у разных записей от 2 до 30 секунд, а цена «от» по каждой странице стоит в таблице выше. Исключение — Gemini Omni 1.1 Flash: там платят за ролик целиком, и у каждого сочетания длительности с разрешением своя сумма.
Резервируется на счёте столько, сколько стоит заказанное: ставка выбранного разрешения на запрошенную длительность. Секунды, которые приносит присланный файл — озвучка портрета под аудио, увеличение готового ролика, перенос движения, — заранее не известны никому, и по таким записям резервируется их предел. Так же считается поле, от которого цена зависит, а в запросе его нет: по самому дорогому допустимому значению, потому что поставщику мы платим за сделанное, а не за просьбу. Когда он ответил, шлюз оставляет фактический расход и возвращает остальное.
Пределы у записей разные: 254 кредита у MiniMax H3 и 8 424 у Seedance 2.0 (выход до 15 с плюс до 15 с видео на входе). Пока задача идёт, свободных кредитов на счёте меньше ровно на отложенную сумму, а сам баланс не двигается; уменьшается он при расчёте и только на то, во что вызов обошёлся. Задача не создастся, когда свободных кредитов не хватает на отложенное под неё, — короткому ролику их нужно меньше, чем длинному. Что списано по каждому вызову, показывает личный кабинет, а само правило разобрано в разделе «Баланс и расход».
Что приходит в ответ и сколько ждать ролик
Ролик не приходит в ответ на запрос: первый вызов возвращает только номер задачи. Готовность спрашивают вторым адресом, и в поле state лежит одно из пяти слов — waiting, queuing, generating, success или fail. Первые три означают, что работа идёт, последние два — что спрашивать больше нечего.
Ссылки на файл лежат в resultJson, и это поле само по себе строка с вложенным JSON внутри. Рядом стоит creditsConsumed — сколько списано за готовый ролик. Ссылка живёт 14 дней, потому что столько результат хранит поставщик, и ролик лучше забрать к себе сразу.
Дольше 60 минут задача не живёт. По истечении срока она закрывается неудачей, и отложенные под неё кредиты возвращаются целиком. Значит, опрос всегда чем-то кончается: либо готовым роликом, либо отказом с причиной в поле failCode.
- Постановка. Первый запрос создаёт задачу и возвращает её номер; ролика в этом ответе нет и быть не может.
- Опрос. Вторым адресом спрашивают состояние — шаг опроса 3 секунды, а сам опрос пропускается до 300 раз в минуту на ключ.
- Ожидание. Пока в поле state стоит одно из первых трёх слов, работа идёт, и спрашивать надо снова.
- Готовность. Слово success означает, что ссылки лежат в resultJson, а рядом стоит списанная за ролик сумма.
- Забрать. Ролик скачивают к себе сразу: ссылка ведёт в хранилище поставщика и живёт ограниченный срок.
Успешный ответ на постановку — ещё не результат, и читать в нём надо поле состояния, а не поле со ссылками. Оборвавшийся запрос опроса не означает, что задача пропала: её состояние спрашивают тем же номером ещё раз. Сам опрос тоже расходует лимит запросов, поэтому паузу между обращениями держат, а не спрашивают в цикле без остановки.
Хранить у себя ссылку вместо самого файла — это поломка, которая проявится позже. Просроченный адрес отвечает не пропажей файла, а отказом по проверке доступа, и по одному этому ответу причина не читается.
Есть ли бесплатная генерация видео
Бесплатный безлимитный API ключ для генерации видео устроен у нас так: сам ключ выдаётся бесплатно, а плата берётся за сделанные секунды. Каждую секунду готового ролика мы оплачиваем поставщику, поэтому счёт начинается с первого запуска. Бесплатный запуск без входа открыт у картинок и у чата, а ролик запускают уже со счёта.
Первые ролики выходят без вложений: при первом входе новому счёту начисляется 50 кредитов. Тратятся они по обычной цене видеокаталога, и ни запись, ни разрешение при этом не ограничены. Сколько секунд из них выйдет, зависит от ставки за секунду у выбранной записи.
После приветственных кредитов баланс пополняется рублями — пакетами на странице цен. Платят при этом за сделанные секунды, а не за месяц, и задача, кончившаяся неудачей, возвращает отложенные кредиты целиком.
Видео из России: без VPN и с оплатой рублями
Генерировать видео из России можно без VPN. Запрос уходит на адрес шлюза, а до ByteDance, Kuaishou, Google, Kling, MiniMax и Alibaba доводим его мы: обращаться к поставщику самому не приходится ни по одной записи каталога.
Платят за ролики так же, как за остальной каталог: оплата рублями с карты российского банка. Продавец российский, поэтому ни валютного перевода, ни карты иностранного банка не потребуется.
Отдельного ключа под видео заводить не надо. Ключ, которым вызываются картиночные и текстовые модели каталога, открывает и все 18 видеозаписей; выпускается он в личном кабинете. Учётные записи у ByteDance, Kuaishou, Google, Kling, MiniMax и Alibaba тоже не понадобятся — расчёты с ними ведём мы.