Перейти к основному содержанию

Обзор

Grok Imagine Video — это официальный канал для видеомоделей xAI: запросы перенаправляются через APIYI в официальный API xAI, стоимость соответствует прайс-листу xAI, а тарификация рассчитывается по количеству сгенерированных секунд и разрешению. API представляет собой совместимый с OpenAI Videos эндпоинт асинхронных задач (/v1/videos) с поддержкой режимов text-to-video и image-to-video, при этом каждое видео содержит звуковую дорожку. Доступны три модели:
  • grok-imagine-video: базовая модель, 480p / 720p
  • grok-imagine-video-1.5: более новая модель, 480p / 720p / 1080p
  • grok-imagine-video-1.5-lite: облегченная версия 1.5, самая низкая цена при 480p / 720p
🔒 Для этого канала требуется группа GrokOfficial, доступ предоставляется по заявкеGrok Imagine Video не входит в группу Default. Политика безопасности контента этого семейства существенно отличается от других моделей на платформе, поэтому для снижения комплаенс-рисков доступ предоставляется выборочно:
  • Действующие клиенты с суммарными расходами от $1,000+: свяжитесь с поддержкой, опишите ваш сценарий использования, и мы подключим доступ после проверки
  • Все остальные пользователи: подайте заявку через поддержку в WeCom, описав ваш сценарий использования и механизмы модерации контента; мы подключим доступ после одобрения
Token без группы GrokOfficial возвращает 503 — это проблема с правами доступа, а не сбой сервиса. См. раздел Настройка группы ниже.
⚠️ Без указания size по умолчанию используются 480p и 8 секундЕсли отправить запрос без указания разрешения или длительности, видео будет сгенерировано и тарифицировано как 480p, 8 секунд. Чтобы получить разрешение 720p / 1080p или более короткий ролик, явно передайте size (например, "1280x720") и seconds.

API генерации видео

Отправка задач text-to-video / image-to-video с интерактивным Playground.

Официальные изображения 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, чтобы получить текстовую версию этой страницы; …

  1. Выберите одну модель: 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.
  • Дополнительно действуют многоуровневые бонусы за пополнение; корпоративные клиенты с крупными объёмами могут обратиться в отдел продаж для обсуждения индивидуальных тарифов.

Настройка группы

Grok Imagine Video не входит в группу Default. Он находится в группе GrokOfficial (та же цена, что и у xAI, то есть в таблице выше) вместе с официальными изображениями Grok Imagine, и доступ к нему необходимо запрашивать.

Кто может получить доступ

Как подать заявку

1

Обратитесь в службу поддержки WeCom

Подайте заявку через поддержку WeCom или напишите на [email protected]. Укажите, что вы подаете заявку на GrokOfficial (Grok Imagine Official).
2

Опишите сценарий использования и меры модерации

Осветите три момента: для чего создаются видео, кто является конечными пользователями и какие процедуры проверки контента и ручного контроля действуют на вашей стороне. Чем конкретнее информация, тем быстрее пройдет рассмотрение.
3

Переключите группу Token после одобрения

После одобрения мы включим GrokOfficial для вашего аккаунта. Перейдите на страницу Token в консоли, переключите Token, используемый для этого канала, на GrokOfficial и установите режим тарификации на Pay-as-you-go Priority или Pay-as-you-go.
Как это выглядит до предоставления доступа: Token без группы GrokOfficial возвращает 503 (нет доступного канала в текущей группе). Повторные попытки не помогут — сначала необходимо подключить группу.Не используйте режим тарификации Pay-per-request: этот канал тарифицируется посекундно, поэтому Token с оплатой за запрос не сможет быть маршрутизирован и также вернет 503.
Напоминание о соблюдении требований: после предоставления доступа ответственность за сгенерированный контент несет вызывающая сторона. Соблюдайте местное законодательство и нормативные требования; запрещено генерировать незаконный контент, материалы, нарушающие права на изображение или интеллектуальную собственность третьих лиц, а также контент, не предназначенный для несовершеннолетних. При распространении среди конечных пользователей добавьте собственный уровень модерации. Подробнее: Рекомендации по соблюдению требований при обращении к зарубежным моделям. В случае выявления нарушений доступ к группе аннулируется.

Технические характеристики

Эндпоинты

Основной домен https://api.apiyi.com, резервный домен https://b.apiyi.com. Полные примеры кода: API генерации видео.

Сквозной процесс (Python)

Ключевые параметры

size (разрешение и соотношение сторон)

size использует WIDTHxHEIGHT пикселей; шлюз выбирает уровень разрешения по меньшей стороне и сопоставляет соотношение сторон с ближайшим поддерживаемым: Вы также можете передавать "480p" / "720p" / "1080p" напрямую или пропустить size и отправить нативные поля xAI resolution (480p / 720p / 1080p) плюс aspect_ratio (например, 9:16); если присутствуют оба варианта, приоритет имеют resolution / aspect_ratio. Если не указан ни один, видео генерируется в разрешении 480p.
grok-imagine-video поддерживает только 480p / 720p; значение size класса 1080p возвращает 400: grok-imagine-video resolution must be one of 480p, 720p.

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).

Рекомендации

1

Тестируйте prompt длительностью 1–2 секунды и с разрешением 480p

Тарификация посекундная, поэтому проверяйте визуальный результат на коротких роликах низкого разрешения перед генерацией финальной версии в 720p / 1080p. У grok-imagine-video-1.5-lite самый низкий тариф для 480p / 720p, и эта модель отлично подходит для массовых экспериментов.
2

Всегда передавайте size и seconds

Если их не указать, по умолчанию применятся 480p и 8 секунд — самая частая причина вопросов «почему это так дорого» и «почему всё такое размытое».
3

Опрашивайте статус каждые 5–10 секунд с общим таймаутом

Задачи обычно завершаются за время от 20 секунд до 2 минут. Более частый опрос ничего не дает; ограничьте общее время ожидания 10 минутами и логируйте task ID для диагностики в случае таймаута.
4

Обрабатывайте блокировки модерации

Проверяйте error.code в ответе со статусом: moderation_blocked означает, что задача была заблокирована, видео не создано, а тарификация списана. Перед повторной отправкой перефразируйте prompt, а не повторяйте запрос в исходном виде.
5

Сразу сохраняйте видео

Скачивайте файл из /content сразу же, как только задача получит статус completed; не храните ссылку на скачивание долго и не передавайте её конечным пользователям.

Коды ошибок и повторные попытки

FAQ

Почти наверняка дело в правах доступа: у группы Token нет GrokOfficial либо для Token установлен режим тарификации с оплатой за запрос. В первом случае подайте заявку через Настройка групп; во втором — переключите режим тарификации на Pay-as-you-go Priority или Pay-as-you-go.
Это параметры по умолчанию: без size и seconds задача генерируется и тарифицируется в качестве 480p длительностью 8 секунд. Передавайте size (например, "1280x720") и seconds явно.
Проверьте ответ со статусом на наличие error.code: "moderation_blocked". Если он присутствует, модерация контента xAI заблокировала видео: задача по-прежнему возвращает completed, но самого видео нет, и за него списывается плата (xAI взимает оплату и за заблокированные видео). Скорректируйте prompt или исходное изображение и отправьте запрос повторно.
Нет. По умолчанию видео содержат аудиодорожку, и согласно тарифам xAI отключение звука не снижает стоимость.
Генерация image-to-video наследует пропорции кадра исходного изображения. Если требуется определённое соотношение сторон, обрежьте входное изображение до нужных пропорций перед отправкой.
В настоящее время этот канал поддерживает text-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

Связанная документация