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

Authorizations

TT-API-KEY
string
header
required

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

Body

application/json
prompt
string
required

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

model
enum<string>
default: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 сек, только одно референс-изображение и оно обязательно
Available options:
grok-imagine-video-1.5-fast,
grok-imagine-video,
grok-imagine-video-1.5
Example:

"grok-imagine-video-1.5-fast"

aspect_ratio
enum<string>
default:16:9

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

Available options:
2:3,
3:2,
1:1,
9:16,
16:9
video_length
string
default: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>
default:720p

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

Available options:
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']

first_frame
string

URL изображения первого кадра. Поддерживается только моделью grok-imagine-video-1.5-fast. Используется для указания первого кадра видео.

last_frame
string

URL изображения последнего кадра. Поддерживается только моделью grok-imagine-video-1.5-fast. Используется для указания последнего кадра видео. Когда first_frame и last_frame используют одно и то же изображение, создаётся эффект зацикливания (loop).

reference_audios
object[]

Массив голосовых персонажей, до 3 записей. Пример: [{"voice_id": "sirius"}]

Maximum array length: 3
Example:
hook_url
string

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

Example:

"https://example.com/callback"

Response

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

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on September 2, 2026