Skip to main content
POST
cURL
Генерация видео выполняется асинхронно. После успешной отправки используйте возвращенный jobId в API получения видео.

Авторизации

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

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

Тело

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

Промпт для видео

Пример:

"A cinematic shot of a futuristic city at sunset"

model
enum<string>
по умолчанию:omni-flash
обязательно

Модель видео.

Доступные опции:
veo-3.1-fast,
veo-3.1-quality,
veo-3.1-lite,
omni-flash
aspect_ratio
enum<string>
обязательно

Соотношение сторон видео. Обязательный параметр.

Доступные опции:
16:9,
9:16
Пример:

"16:9"

resolution
enum<string>

Уровень разрешения. Доступен только для модели omni-flash. Варианты: 720p, 1080p.

Доступные опции:
720p,
1080p
Пример:

"720p"

duration
enum<string>

Длительность видео (секунды). Модели Veo 3.1 (veo-3.1-fast, veo-3.1-quality, veo-3.1-lite) поддерживают только 8.

Доступные опции:
4,
6,
8,
10
Пример:

"8"

generation_type
enum<string>

Тип генерации видео. frame: кадр-в-видео; reference: видео по референс-изображениям. Если не указан, определяется автоматически по количеству изображений: 2 изображения = кадр-в-видео, 3 изображения = видео по референс-изображениям.

Доступные опции:
frame,
reference
Пример:

"frame"

reference_images
string[]

Референс-изображения, максимум 3. Каждый элемент — http(s):// URL. Поддерживаются JPEG и PNG.

Maximum array length: 3
Пример:
reference_videos
string[]

Референсное / редактируемое видео, максимум 1 (несколько видео-референсов не поддерживаются). Каждый элемент — http(s):// URL. Сейчас доступно только для модели omni-flash.

Maximum array length: 1
Пример:
hookUrl
string

URL обратного вызова для уведомления о завершении или ошибке

Пример:

"https://example.com/callback"

Ответ

Задача успешно отправлена

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

Статус задачи

Пример:

"SUCCESS"

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

Сообщение задачи

Пример:

"success"

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