Skip to main content
POST
cURL
Это эндпоинт видео API Grok для генерации видео по тексту. Создание видео только по prompt, без медиафайлов.
Внимание: NSFW-контент запрещён. Одиночный или случайный сбой модерации не повлечёт никаких расходов. Однако повторные сбои модерации могут привести к списанию средств.

Авторизации

TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в панель управления TTAPI.

Тело

application/json

Параметры запроса генерации видео по тексту

prompt
string
обязательно

Промпт. Максимальная длина 4096 символов для grok-imagine-video и grok-imagine-video-1.5; grok-imagine-video-1.5-fast поддерживает более длинные промпты.

model
enum<string>
по умолчанию:grok-imagine-video-1.5-fast

Название модели.

  • grok-imagine-video-1.5-fast: длительность 6-30 сек (6 сек и 10 сек — стандартная длительность; 7 сек и 11 сек не поддерживаются); поддерживает несколько референс-изображений (макс. 7); поддерживает контроль первого/последнего кадра
  • grok-imagine-video: длительность 1-15 сек, поддерживает несколько референс-изображений (одно изображение до 15 сек, несколько изображений макс. 10 сек), только 720P
  • grok-imagine-video-1.5: длительность 1-15 сек, только одно референс-изображение и оно обязательно
Доступные опции:
grok-imagine-video-1.5-fast,
grok-imagine-video,
grok-imagine-video-1.5
Пример:

"grok-imagine-video-1.5-fast"

aspect_ratio
enum<string>
по умолчанию:16:9

Соотношение сторон видео

Доступные опции:
2:3,
3:2,
1:1,
9:16,
16:9
video_length
string
по умолчанию:10

Длительность видео в секундах. grok-imagine-video-1.5-fast диапазон: от 6 до 30 (6 сек и 10 сек — стандартная длительность); grok-imagine-video диапазон: от 1 до 15 (одно изображение до 15 сек, несколько изображений макс. 10 сек); grok-imagine-video-1.5 диапазон: от 1 до 15.

resolution_name
enum<string>
по умолчанию:720p

Разрешение вывода. 480p и 720p поддерживаются всеми моделями; 1080p поддерживается только моделью grok-imagine-video-1.5.

Доступные опции:
480p,
720p,
1080p
hook_url
string

Адрес обратного вызова URL. Когда задача будет выполнена или не выполнена, на этот адрес будут отправлены уведомления. Структура данных уведомления соответствует структуре получение результата [blocked]. Если не установлено, вам необходимо вызвать интерфейс получение результата [blocked] для запроса результата.

Пример:

"https://example.com/callback"

Ответ

Запрос выполнен успешно

status
string
обязательно
Пример:

"SUCCESS"

message
string
обязательно
Пример:

"success"

data
object
обязательно
Пример:
Последнее изменение 9 сентября 2026 г.