Skip to main content
POST
cURL
Это эндпоинт видео API Grok для генерации видео по референсу. Используйте refer_images для референс-изображений или reference_audios для голосовых персонажей в сочетании с 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
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']

reference_audios
object[]

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

Maximum array length: 3
Пример:
hook_url
string

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

Пример:

"https://example.com/callback"

Ответ

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

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

"SUCCESS"

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

"success"

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