Перейти к основному содержанию
POST

Способы ввода

URL изображений должны быть доступны через публичный HTTP(S). Поддерживаются JPEG и PNG, не более 10 MiB на изображение. К любому способу генерации можно добавить референсное аудио Suno. Передайте song_id и при необходимости укажите интервал через song_window.start_s и song_window.end_s. Длина интервала должна равняться duration. Если интервал не указан, используется фрагмент нужной длительности с начала песни. Для lip_sync: true требуется song_id.

Авторизации

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

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

Тело

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

Опишите сцену, движение камеры и стиль.

Required string length: 1 - 30000
duration
integer
обязательно

Длительность генерации в секундах.

Требуемый диапазон: 5 <= x <= 15
resolution
enum<string> | null
по умолчанию:480p

Выходное разрешение. 480p соответствует fast, 720p — standard.

Доступные опции:
480p,
720p
aspect_ratio
enum<string> | null
по умолчанию:9:16

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

Доступные опции:
1:1,
9:16,
16:9,
4:3,
3:4
first_frame_url
string<uri>

Публичный HTTP(S) URL изображения первого кадра. Можно использовать отдельно, с последним кадром или с референсными изображениями.

last_frame_url
string<uri>

Публичный HTTP(S) URL изображения последнего кадра. Требуется также передать первый кадр; сочетание первого и последнего кадров не поддерживает референсные изображения.

reference_image_urls
string<uri>[]

До 9 изображений. Можно использовать отдельно или вместе с первым кадром.

Maximum array length: 9

Публичный HTTP(S) URL референсного изображения.

song_id
string

ID песни Suno для референсного аудио. Можно сочетать с изображениями.

song_window
object

Интервал референсного аудио. Требуется song_id. Если не указан, используется фрагмент с нулевой секунды длительностью, равной длительности видео.

lip_sync
boolean
по умолчанию:false

Включить синхронизацию губ. При значении true требуется song_id.

hookUrl
string<uri>

Необязательный URL вебхука. После завершения задачи результат отправляется методом HTTP POST; тело совпадает с ответом Fetch V2 для видеозадачи.

Ответ

Задача принята. Используйте data.jobId для получения результата.

status
enum<string>
обязательно
Доступные опции:
SUCCESS
message
string
обязательно

Сообщение о принятии задачи.

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