Перейти к основному содержанию
POST
/
gemini
/
video
/
generations
cURL
curl --request POST \
  --url https://api.ttapi.org/gemini/video/generations \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "A cinematic shot of a futuristic city at sunset",
  "model": "omni-flash",
  "aspect_ratio": "16:9",
  "reference_images": [
    "https://cdn.ttapi.io/example/reference-image.png",
    "https://cdn.ttapi.io/example/reference-video.mp4"
  ],
  "hookUrl": "https://example.com/callback"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "0ccf0606-3f32-4090-85bd-1786e4593be5"
  }
}
Генерация видео выполняется асинхронно. После успешной отправки используйте возвращенный 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
обязательно

Модель видео. Сейчас поддерживается только omni-flash.

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

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

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

"16:9"

reference_images
string[]

URL референсных материалов. Поддерживаются ссылки на изображения и видео; пустые строки игнорируются.

Пример:
[
"https://cdn.ttapi.io/example/reference-image.png",
"https://cdn.ttapi.io/example/reference-video.mp4"
]
hookUrl
string

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

Пример:

"https://example.com/callback"

Ответ

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

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

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

Пример:

"SUCCESS"

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

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

Пример:

"success"

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