curl --request POST \
--url https://api.ttapi.io/suno/v1/video/generate \
--header 'Content-Type: application/json' \
--header 'TT-API-KEY: <api-key>' \
--data '
{
"prompt": "Бумажный фонарик медленно поднимается в звёздное небо, камера следует за ним вверх.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "9:16",
"hookUrl": "https://example.com/webhooks/suno-video"
}
'{
"status": "SUCCESS",
"message": "success",
"data": {
"jobId": "video-9c64b7e1-f00d-456e-8c56-a0227f5128fb"
}
}{
"status": "FAILED",
"message": "<string>",
"data": {}
}{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}Suno
API генерации видео Suno
Генерируйте видео из текста, изображений или референсного аудио Suno и получайте асинхронные результаты через Fetch V2.
POST
/
suno
/
v1
/
video
/
generate
curl --request POST \
--url https://api.ttapi.io/suno/v1/video/generate \
--header 'Content-Type: application/json' \
--header 'TT-API-KEY: <api-key>' \
--data '
{
"prompt": "Бумажный фонарик медленно поднимается в звёздное небо, камера следует за ним вверх.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "9:16",
"hookUrl": "https://example.com/webhooks/suno-video"
}
'{
"status": "SUCCESS",
"message": "success",
"data": {
"jobId": "video-9c64b7e1-f00d-456e-8c56-a0227f5128fb"
}
}{
"status": "FAILED",
"message": "<string>",
"data": {}
}{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}Способы ввода
| Способ генерации | Параметры изображений |
|---|---|
| Видео из текста | Передайте только промпт и длительность; при необходимости задайте разрешение, модель и соотношение сторон |
| Из первого кадра | first_frame_url |
| Первый и последний кадры | first_frame_url и last_frame_url |
| Референсные изображения | reference_image_urls, до 9 изображений |
| Первый кадр с референсными изображениями | first_frame_url и reference_image_urls |
song_id и при необходимости укажите интервал через song_window.start_s и song_window.end_s. Длина интервала должна равняться duration. Если интервал не указан, используется фрагмент нужной длительности с начала песни. Для lip_sync: true требуется song_id.Авторизации
Вы можете получить API-ключ в панель управления TTAPI.
Тело
application/json
Последнее изменение 20 ноября 2026 г.