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
Suno 视频生成 API
通过文字、图片或 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。授权
请前往 TTAPI 控制台 获取 API 密钥。
请求体
application/json
最后修改于 2026年11月20日