Обзор
Grok Imagine Video — это официальный канал для видеомоделей xAI: запросы перенаправляются через APIYI в официальный API xAI, стоимость соответствует прайс-листу xAI, а тарификация рассчитывается по количеству сгенерированных секунд и разрешению. API представляет собой совместимый с OpenAI Videos эндпоинт асинхронных задач (/v1/videos) с поддержкой режимов text-to-video и image-to-video, при этом каждое видео содержит звуковую дорожку.
Доступны три модели:
grok-imagine-video: базовая модель, 480p / 720pgrok-imagine-video-1.5: более новая модель, 480p / 720p / 1080pgrok-imagine-video-1.5-lite: облегченная версия 1.5, самая низкая цена при 480p / 720p
API генерации видео
Официальные изображения Grok Imagine
GrokOfficial — генерация изображений по ценам xAI в зависимости от уровня.Интеграция с помощью ИИ-агента
Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor
Он сначала загрузит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код под ваш стек — асинхронный трехэтапный процесс, параметры по умолчанию (480p / 8 секунд), тарифицируемые блокировки модерацией и немедленное сохранение видео уже включены в требования.
Интегрируйте / проведите отладку генерации видео Grok Imagine (text-to-video + image-to-video) в этом проекте.
Перед написанием кода изучите документацию: загрузите https://docs.apiyi.com/en/api-capabilities/grok-imagine-video/overview.md, чтобы получить текстовую версию этой страницы; …
- Выберите одну модель:
grok-imagine-video,grok-imagine-video-1.5илиgrok-imagine-video-1.5-lite…
Всего 8 требований — используйте кнопку ниже, чтобы скопировать полную версию
Модели и цены
Тарифы соответствуют официальным ценам xAI, а тарификация производится за секунду сгенерированного видео; ставка зависит от модели и разрешения:- Стоимость = секунды × тариф за секунду + входные изображения × плата за изображение. Пример: задача image-to-video длительностью 1 секунда в разрешении 480p на
grok-imagine-video= 1 × $0.05 + 1 × $0.002 = $0.052 (соответствует списанию в наших тестах). - Значения по умолчанию также тарифицируются: без параметров
size/secondsзадача запускается в 480p на 8 секунд — $0.40 наgrok-imagine-video. - Аудио не тарифицируется отдельно: видео по умолчанию содержат аудиодорожку, и её отключение не снижает цену.
- Блокировки модерации тарифицируются: xAI взимает плату за видео, заблокированные её модерацией, и мы списываем средства на тех же условиях — см. FAQ.
- Дополнительно действуют многоуровневые бонусы за пополнение; корпоративные клиенты с крупными объёмами могут обратиться в отдел продаж для обсуждения индивидуальных тарифов.
Настройка группы
Кто может получить доступ
Как подать заявку
Обратитесь в службу поддержки WeCom
GrokOfficial (Grok Imagine Official).Опишите сценарий использования и меры модерации
Переключите группу Token после одобрения
GrokOfficial для вашего аккаунта. Перейдите на страницу Token в консоли, переключите Token, используемый для этого канала, на GrokOfficial и установите режим тарификации на Pay-as-you-go Priority или Pay-as-you-go.GrokOfficial возвращает 503 (нет доступного канала в текущей группе). Повторные попытки не помогут — сначала необходимо подключить группу.Не используйте режим тарификации Pay-per-request: этот канал тарифицируется посекундно, поэтому Token с оплатой за запрос не сможет быть маршрутизирован и также вернет 503.Технические характеристики
Эндпоинты
Сквозной процесс (Python)
Ключевые параметры
size (разрешение и соотношение сторон)
size использует WIDTHxHEIGHT пикселей; шлюз выбирает уровень разрешения по меньшей стороне и сопоставляет соотношение сторон с ближайшим поддерживаемым:
"480p" / "720p" / "1080p" напрямую или пропустить size и отправить нативные поля xAI resolution (480p / 720p / 1080p) плюс aspect_ratio (например, 9:16); если присутствуют оба варианта, приоритет имеют resolution / aspect_ratio. Если не указан ни один, видео генерируется в разрешении 480p.
seconds (продолжительность)
Целое число от 1 до 15, в виде строки ("5") или числа (5); по умолчанию 8. Значения вне диапазона возвращают 400: duration must be an integer between 1 and 15. Стоимость зависит от количества секунд, поэтому при тестировании используйте 1–2 секунды.
input_reference (генерация видео по изображению)
Передайте одно входное изображение, чтобы перевести задачу в режим генерации видео по изображению. Поддерживается любой из трех форматов:
- Публичный URL изображения:
"input_reference": "https://example.com/first-frame.jpg" - URI данных base64:
"input_reference": "data:image/jpeg;base64,/9j/4AAQ..." - Загрузка файла через multipart:
-F "[email protected]"
prompt, чтобы описать движение и камеру (например, «the cat slowly turns its head»); выходной кадр следует за входным изображением. Каждое входное изображение стоит дополнительно $0.002 (grok-imagine-video) или $0.01 (1.5 / 1.5-lite).
Рекомендации
Тестируйте prompt длительностью 1–2 секунды и с разрешением 480p
grok-imagine-video-1.5-lite самый низкий тариф для 480p / 720p, и эта модель отлично подходит для массовых экспериментов.Всегда передавайте size и seconds
Опрашивайте статус каждые 5–10 секунд с общим таймаутом
Обрабатывайте блокировки модерации
error.code в ответе со статусом: moderation_blocked означает, что задача была заблокирована, видео не создано, а тарификация списана. Перед повторной отправкой перефразируйте prompt, а не повторяйте запрос в исходном виде.Сразу сохраняйте видео
/content сразу же, как только задача получит статус completed; не храните ссылку на скачивание долго и не передавайте её конечным пользователям.Коды ошибок и повторные попытки
FAQ
Каждый вызов возвращает 503 — канал недоступен?
Каждый вызов возвращает 503 — канал недоступен?
GrokOfficial либо для Token установлен режим тарификации с оплатой за запрос. В первом случае подайте заявку через Настройка групп; во втором — переключите режим тарификации на Pay-as-you-go Priority или Pay-as-you-go.Почему моё видео в разрешении 480p и длится 8 секунд?
Почему моё видео в разрешении 480p и длится 8 секунд?
size и seconds задача генерируется и тарифицируется в качестве 480p длительностью 8 секунд. Передавайте size (например, "1280x720") и seconds явно.Задача сообщает completed, но видео для скачивания отсутствует?
Задача сообщает completed, но видео для скачивания отсутствует?
error.code: "moderation_blocked". Если он присутствует, модерация контента xAI заблокировала видео: задача по-прежнему возвращает completed, но самого видео нет, и за него списывается плата (xAI взимает оплату и за заблокированные видео). Скорректируйте prompt или исходное изображение и отправьте запрос повторно.Без звука получается дешевле?
Без звука получается дешевле?
Почему итоговый размер при генерации image-to-video не совпадает с отправленным?
Почему итоговый размер при генерации image-to-video не совпадает с отправленным?
Поддерживаются ли редактирование видео, продление или несколько референсных изображений?
Поддерживаются ли редактирование видео, продление или несколько референсных изображений?
Какую из трёх моделей выбрать?
Какую из трёх моделей выбрать?
- Требуется 1080p →
grok-imagine-video-1.5(лучшее качество) илиgrok-imagine-video-1.5-lite(дешевле) - Пакетная генерация 480p / 720p при ограниченном бюджете →
grok-imagine-video-1.5-lite($0.02 / $0.03 за секунду) - Уже используете базовую модель и нужно только 480p / 720p →
grok-imagine-video
Связанная документация
- API генерации видео Grok Imagine - справочник по эндпоинту отправки с Playground
- Официальные изображения Grok Imagine - та же группа, цена по уровням аналогична xAI
- Руководство по моделям Grok - текстовые модели xAI
- Бонусы за пополнение