Перейти к основному содержанию
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-lite; grok-imagine-video-1.5-fast поддерживает более длинные промпты.

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

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

Доступные опции:
grok-imagine-video-1.5-fast,
grok-imagine-video,
grok-imagine-video-1.5,
grok-imagine-video-1.5-lite
Пример:

"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, grok-imagine-video-1.5 и grok-imagine-video-1.5-lite диапазон: от 1 до 15.

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

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

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

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

Пример:

"https://example.com/callback"

Ответ

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

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

"SUCCESS"

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

"success"

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