Генерация видео через API в рублях: Grok Imagine 1.5

Сгенерировать видео через API с оплатой в рублях можно: в каталоге KeyDealer есть grok-imagine-video-1.5 на эндпоинте POST /v1/videos/generations. На 28 октября 2026 года ролик длится 15 секунд, 480p, 16:9, стоит 2 ₽ за секунду, то есть 30 ₽. Деньги резервируются заранее и списываются только за успешный ролик.

Ниже — что именно открыто, как выглядит запрос, как опрашивать статус, что происходит с деньгами при сбое и почему прямое сравнение с прайсом xAI требует оговорки.

Можно ли генерировать видео через API из России с оплатой в рублях

Да, если вам подходит один формат ролика. Модель одна, режим один: текстовое описание на входе, MP4 на выходе.

До октября видео в каталоге не было. Модель открыли 19 октября 2026 года после проверочной генерации, и она стоит в живой выдаче GET /v1/models со статусом available. Оплата идёт с того же рублёвого баланса и тем же ключом, что и текстовые модели.

Что умеет grok-imagine-video-1.5 в каталоге

Только одну комбинацию параметров. Её мы проверили, остальные не открывали.

Вертикального 9:16 для коротких роликов нет. Если запросить другую длительность, разрешение или ориентацию, шлюз вернёт ошибку до резерва денег, а не сгенерирует что-то похожее.

Сколько стоит один ролик и когда списываются деньги

Ролик стоит 30 ₽ по базовой ставке каталога, и платите вы только за готовый файл.

Порядок такой. Перед отправкой задачи шлюз резервирует полную сумму на балансе. Пока ролик генерируется, деньги заблокированы, но не списаны. Списание происходит после того, как задача завершилась и файл прошёл проверку: структура MP4, длительность, разрешение, ориентация. Если генерация упала, истёк таймаут или файл не совпал с заявленными параметрами, резерв возвращается целиком.

Персональная цена аккаунта может отличаться от базовой: её показывает GET /v1/balance в поле video_prices. Цена фиксируется в задаче до отправки, и если тариф поменяется, пока ролик в работе, на эту задачу это не повлияет.

KeyDealer решает задачу «встроить генерацию видео в свой продукт и платить в рублях» одним ключом: тот же OpenAI-совместимый доступ, что и к текстовым моделям, оплата российской картой, ролик 15 секунд за 30 ₽ на 28 октября 2026 года, списание только за успешный файл и общий журнал расходов по ключу.

Сколько то же видео стоит у xAI

По прайсу xAI на 28 октября 2026 года grok-imagine-video-1.5 стоит 0,08 доллара за секунду. По курсу ЦБ на 28 октября, 80,5307 ₽ за доллар, это около 6,44 ₽ за секунду и около 96,64 ₽ за 15-секундный ролик.

Наша секунда дешевле в 3,2 раза, но сравнение не полностью честное, и это надо сказать прямо. На странице цен xAI ставка одна и не делится по разрешениям, а в руководстве по генерации видео указано, что для текстовых запросов модель рендерит 1080p. За свои 0,08 доллара вендор даёт больше вариантов, чем мы. Если вам нужен именно 480p и 15 секунд, наша цена ниже. Если нужен 1080p или вертикальный ролик, у нас его пока нет, и цена тут не помощник.

У вендора есть и младшая модель grok-imagine-video-1.5-lite за 0,02 доллара в секунду. В нашем каталоге её нет.

Как считать бюджет на генерацию картинок, разобрано в материале сколько стоит картинка через API: логика «цена за готовый результат, а не за токены» здесь та же.

Как отправить запрос на генерацию

Обычным POST с ключом и обязательным заголовком идемпотентности.

curl https://api.keydealer.ru/v1/videos/generations \
  -H "Authorization: Bearer $KD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: promo-clip-0001" \
  -H "X-KD-Max-Charge-Microrubles: 30000000" \
  -d '{"model":"grok-imagine-video-1.5","prompt":"A red toy car moves across a white tabletop","duration":15,"resolution":"480p","aspect_ratio":"16:9"}'

Обязательные поля: model, prompt, duration, resolution. aspect_ratio по умолчанию 16:9. Промпт — до 8000 символов. Неизвестные параметры шлюз отклоняет, а не молча выкидывает: так вы не заплатите за ролик, который сделан не по вашему запросу.

Idempotency-Key — от 16 до 128 символов: латинские буквы, цифры, _ и -. Заголовок X-KD-Max-Charge-Microrubles необязателен: он задаёт потолок цены в микрорублях, и если тариф окажется выше, запрос отклонится до резерва.

В ответе приходит внутренний идентификатор вида kd_vid_…, состояние задачи, выбранные параметры и блок keydealer_billing.

Как узнать, что ролик готов

Опрашивать статус задачи раз в 10–15 секунд.

curl "https://api.keydealer.ru/v1/videos/$KD_VIDEO_ID" \
  -H "Authorization: Bearer $KD_API_KEY"

Пока задача не завершена, создание и повтор возвращают HTTP 202. Завершённая задача отдаёт 200 с состоянием. Важно: 200 со статусом failed — это не успех. Чужой или несуществующий ID возвращает 404.

На проверочной генерации 19 октября задача завершилась меньше чем за минуту. Это один замер, а не обещание времени ответа: закладывайте таймаут на стороне клиента с запасом. Если задача не завершилась за 30 минут, шлюз сам вернёт резерв.

Как скачать ролик и сколько он хранится

Файл скачивается отдельным запросом через шлюз, без перенаправления на чужой адрес.

curl "https://api.keydealer.ru/v1/videos/$KD_VIDEO_ID/content" \
  -H "Authorization: Bearer $KD_API_KEY" --output result.mp4

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

Окно скачивания — не больше 24 часов. Сохраните файл сразу у себя. Если скачивание временно не прошло, повторяйте скачивание, а не генерацию: вторая генерация — это второй ролик и второй счёт.

Что будет, если запрос сорвётся на середине

Деньги не спишутся дважды, если вы повторяете запрос с тем же Idempotency-Key.

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

Ключ идемпотентности действует в пределах аккаунта, поэтому задачу можно найти и с другого API-ключа того же аккаунта, если первый пришлось перевыпустить. Разница между ошибками, которые стоят денег, и ошибками, которые не стоят, подробно разобрана в материале отказы маршрута и переключение на запасную модель.

Как ограничить расходы на видео

Теми же лимитами ключа, что и текстовые запросы.

Видео попадает в общий журнал использования. Дневной и месячный лимит в рублях учитывают и готовые ролики, и активные резервы. Если на ключе задан список разрешённых моделей, grok-imagine-video-1.5 нужно добавить в него явно, иначе запрос отклонится до резерва. Как настроить лимиты, разобрано в материале лимит расхода на ключ.

Есть и встроенные ограничения: не больше двух незавершённых видеозадач на аккаунт и не больше шести запросов на создание в минуту. Для фоновой очереди роликов это значит, что генерацию надо выстраивать последовательно, а не отправлять пачкой.

В журнале ключа видны модель и стоимость. Текст промпта в журнале задач не хранится.

Что мы проверили 19 октября

Одну генерацию, и только в той комбинации, которую продаём.

Тестовый промпт: красная игрушечная машинка едет по белому столу. Задача завершилась, файл скачался. Параметры итогового MP4: 848×480, 361 кадр, 15,04 секунды, около 1,5 МБ, видео H.264. В контейнере была и звуковая дорожка AAC; что в ней звучит, мы не оценивали. На выборочных кадрах — одна и та же машинка, движущаяся слева направо, без надписей и водяных знаков.

Механику денег — резерв, списание, возврат при несовпадении файла, повтор с тем же ключом — проверили на сохранённом файле без новых платных генераций.

Когда API — не то, что вам нужно

API нужен, если ролик рождается внутри вашего продукта: приложение генерирует видео по запросу пользователя, сервис собирает превью для каталога, бот отвечает клипом. Тогда вам нужен эндпоинт, ключ и предсказуемая цена за задачу.

Если же вы сами снимаете и публикуете, собирать производство на сыром API долго. Для этого у нас есть отдельный сервис TrendMix — готовый ИИ-продакшен: «Режиссёр» раскладывает идею по сценам, персонаж удерживается между эпизодами, есть встроенный редактор, а цена видна до генерации, кредит равен рублю. KeyDealer — для тех, кто встраивает генерацию в свой продукт, TrendMix — для тех, кто делает ролики. Как выбрать между своим кодом и готовым сервисом в целом, разобрано в материале API или готовое решение.

Чего мы не утверждаем

Мы не утверждаем, что генерация стабильна. Платная проверка была одна. Одна успешная генерация не доказывает непрерывной надёжности, и отдельные задачи могут завершаться ошибкой — тогда резерв возвращается.

Мы не утверждаем, что ролик совпадёт с замыслом. Шлюз проверяет параметры файла: длительность, разрешение, ориентацию и структуру. Содержание кадра относительно промпта не проверяется.

Мы не утверждаем, что цены неизменны. Ставка xAI и курс ЦБ взяты на 28 октября 2026 года. Перед расчётом бюджета сверяйтесь с первоисточниками и с GET /v1/balance.

Что держать в голове

Первое. Сейчас открыт ровно один формат: 15 секунд, 480p, 16:9, только из текста. Если задача требует вертикали или высокого разрешения, планируйте её отдельно.

Второе. Платите за готовый проверенный файл, а не за попытку. Резерв, списание при успехе и возврат при сбое — штатная механика, но повтор без Idempotency-Key — это новая задача.

Третье. Сохраняйте ролик сразу: окно скачивания не больше суток, а повторная генерация оплачивается заново. Что мы за проект — на странице о проекте, ключ заводится на keydealer.ru/login.