Suno Video 可生成 5 至 15 秒视频,支持歌曲参考音频和口型同步。按请求秒数估算费用,一次请求的价格已包含两条输出。可用首尾帧或参考图引导画面,再通过 Fetch V2 分别检查结果。
Suno Video 接入 TTAPI
TTAPI 于 2026 年 11 月 20 日新增 Suno Video,模型标识为 video-1。生成接口支持文本、首帧图、首尾帧和参考图,每次请求指定 5 至 15 秒,输出可选 480p 或 720p。
需要围绕音乐创作时,可以添加已有 Suno 歌曲作为参考音频,并按需开启口型同步。可用于尝试歌曲预告、角色表演和短视频创作;正式采用前,仍需按自己的创作要求检查生成结果。
Suno Video API 价格:按秒计费,包含两条输出
TTAPI 按请求中填写的秒数计费,公布的单价已包含一次请求返回的两条视频。不能因为响应中有两条视频,就再把整次请求的费用乘以二。
下表直接使用模型页的费率,按 1 quota 约合 0.01 美元换算。例如,5 秒请求在 480p 下为 60 quota,在 720p 下为 120 quota。表中为请求费用估算,实际扣费以任务返回的 quota 和控制台账单为准。Suno 应用的订阅、Visual credits 与 TTAPI quota 分别计费。音频价格表中原有的 /suno/v1/generateVideo 操作接收 music_id,单独列为免费;本节费率适用于 /suno/v1/video/generate。
| 分辨率 | 每秒 | 5 秒请求 | 10 秒请求 | 15 秒请求 |
|---|---|---|---|---|
| 480p | 12 quota · $0.12 / 秒 | 60 quota · $0.60 | 120 quota · $1.20 | 180 quota · $1.80 |
| 720p | 24 quota · $0.24 / 秒 | 120 quota · $1.20 | 240 quota · $2.40 | 360 quota · $3.60 |
每项费用均包含一次请求的两条输出,美元金额为近似换算。
选择文本、首尾帧或参考图
提示词可依次描述主体、动作、镜头和风格。需要确定开场构图时填写 first_frame_url;需要控制结尾时,同时填写 last_frame_url。首尾帧模式不能再加入 reference_image_urls。
reference_image_urls 最多支持 9 张参考图,也可与首帧组合。输入图像须为公开可访问的 HTTP(S) 链接,使用 JPEG 或 PNG 格式,每张不超过 10 MiB。宽高比支持 1:1、9:16、16:9、4:3 和 3:4,默认为 9:16。
发送第一个 Suno Video 请求
从服务端向 /suno/v1/video/generate 发送 POST 请求,在请求头传入 TT-API-KEY,请求体使用 JSON。当前接口定义要求 prompt 和 duration。分辨率默认为 480p,720p 对应标准输出。下方最小示例与模型详情页保持一致。
更新日志将模型标识为 video-1。生成文档正文提到可传 model,但 OpenAPI 请求定义和示例均未列出该字段。本文请求示例以 OpenAPI 定义为准。
提交成功后返回 data.jobId,可用于查询结果。生成和查询结果都需要具有 Suno Video 权限的 API 密钥。
curl --request POST \
--url https://api.ttapi.io/suno/v1/video/generate \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{"prompt":"A paper lantern rises into a starry sky as the camera follows it upward.","duration":5,"resolution":"480p","aspect_ratio":"9:16"}'加入 Suno 歌曲与口型同步
song_id 用于引用已有 Suno 歌曲。选填的 song_window 以秒为单位,支持非负小数。start_s 默认为 0,end_s 默认为 start_s + duration。显式填写 end_s 时,两者之差必须等于 duration。
需要角色跟随歌曲进行口型表演时,将 lip_sync 设为 true,并提供 song_id。示例的 5 秒视频使用歌曲第 2 秒至第 7 秒的片段。请把 YOUR_SUNO_SONG_ID 替换为可用的歌曲 ID;这是一份请求模板,并非实际生成记录。
curl --request POST \
--url https://api.ttapi.io/suno/v1/video/generate \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{"prompt":"A puppet sings on a softly lit stage, facing the camera.","duration":5,"resolution":"720p","aspect_ratio":"9:16","song_id":"YOUR_SUNO_SONG_ID","song_window":{"start_s":2,"end_s":7},"lip_sync":true}'查询任务并处理两条视频结果
通过 GET /suno/v2/fetch 查询任务,把提交响应中的 data.jobId 作为查询参数 jobId。ON_QUEUE 表示等待或处理中,此时 data.videos 可能为空。SUCCESS 时检查 data.videos 中各项的 status、video_url 和可用素材信息。数组最多包含两项。
FAILED 时查看 message 以及各条视频的 error 和 error_code。video_url 和 asset 可能为 null。提交时设置 hookUrl 后,TTAPI 会在任务完成时发送 HTTP POST 回调,内容与 Fetch V2 响应相同。保存结果链接,并对重复通知去重。
curl --get \
--url https://api.ttapi.io/suno/v2/fetch \
--header "TT-API-KEY: $TTAPI_KEY" \
--data-urlencode "jobId=$JOB_ID"规划音乐短视频工作流
首次试用可从一个明确场景和一段短歌曲开始,对比两条候选视频的构图、动作与表演是否符合创作要求。需要更高输出分辨率时,再切换到 720p,并按其每秒费率安排预算。
文中嵌入的是 Suno Visuals 官方宣传展示,时长超过单次 API 的 5 至 15 秒,官方未公布原始提示词或参数。它可作为视觉创作参考;请求限制和接入行为请以 TTAPI 模型页为准。
- 请求时长保持在 5 至 15 秒。
- 开启口型同步前,确认歌曲片段长度与 duration 相同。
- 检查两条视频的状态以及任务扣费。
