Skip to main content
POST
cURL
Начните с этой страницы, если вам нужен основной эндпоинт генерации в видео API Grok. Полный список эндпоинтов, рекомендации по рабочему процессу и связанные ссылки см. в обзоре видео API Grok.

Авторизации

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)
  • 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
refer_images
string[]

URL референс-изображений. grok-imagine-video-1.5-fast поддерживает несколько изображений (макс. 7); grok-imagine-video поддерживает несколько изображений (одно изображение до 15 сек, несколько изображений макс. 10 сек); grok-imagine-video-1.5 поддерживает только одно изображение и оно обязательно.
['https://cdn.ttapi.io/other/2026-03-13/a86ca2c7-6333-4840-b337-395a5d02a182.png','https://cdn.ttapi.io/other/2026-03-13/64a858ed-6095-45ce-92d5-b515c9864703.png']

hook_url
string

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

Пример:

"https://example.com/callback"

Ответ

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

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

"SUCCESS"

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

"success"

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