Skip to main content
POST
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
  • Модель генерации видео Grok Imagine Video 1.5 через официальный канал
  • Выбор модели grok-imagine-video-1.5-official через параметр model
  • Только генерация по первому кадру — требуется ровно одно входное изображение
  • Выходное разрешение до 1080p
  • Асинхронное управление задачами, запрос результатов по ID задачи
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 в reference_images. Пожалуйста, сначала загрузите изображения через API загрузки изображений, а затем вызовите данный API с полученным URL.

Authorizations

string
обязательно
Все запросы к API требуют аутентификации по Bearer TokenПолучение API Key: посетите страницу управления API-ключамиДобавьте в заголовки запроса:

Body

string
по умолчанию:"grok-imagine-video-1.5-official"
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • grok-imagine-video-1.5-official - модель Grok Imagine Video 1.5 официального канала
Пример: "grok-imagine-video-1.5-official"
string
обязательно
Текстовое описание для генерации видео
string
обязательно
URL изображения первого кадра. Обязателен — модель поддерживает только генерацию по одному входному изображению. Поддерживаются только публичные URL http:// или https://.
integer
по умолчанию:"8"
Длительность видео в секундахПоддерживаемый диапазон: 1–15 секунд
string
по умолчанию:"720p"
Разрешение видеоПоддерживаемые значения: 480p, 720p, 1080p
string
Соотношение сторон видеоПоддерживаемые форматы:
  • 16:9 (горизонтальный)
  • 9:16 (вертикальный)
  • 4:3 (горизонтальный)
  • 3:4 (вертикальный)
  • 3:2 (горизонтальный)
  • 2:3 (вертикальный)
  • 1:1 (квадратный)
string[]
Массив дополнительных URL референсных изображений⚠️ Поддерживается только формат URL (base64 больше не поддерживается)
  • Публично доступные URL изображений (http:// или https://)
  • Всего до 7 изображений в image и reference_images
  • Используйте API загрузки изображений для загрузки локальных изображений и получения URL
Примечание о тарификации: Выходное видео тарифицируется посекундно по тарифу разрешения. Каждое входное изображение тарифицируется за штуку — поскольку модель требует ровно одно изображение первого кадра, каждая задача включает один платёж за входное изображение. Продление видео этой моделью не поддерживается.

Response

string
Уникальный идентификатор задачи для проверки статуса
string
Тип объекта, всегда generation.task
string
Название использованной модели
string
Статус задачи
  • queued - ожидает обработки
  • in_progress - обрабатывается
  • completed - успешно завершена
  • failed - ошибка
integer
Временная метка создания задачи (Unix timestamp)
integer
Прогресс задачи, обычно 0 сразу после отправки
object
Метаданные задачи