Suno Video
通过 TTAPI 的 Suno Video API,使用 video-1 按文本、首尾帧或参考图生成 5 至 15 秒视频,支持 480p、720p、Suno 歌曲参考音频和口型同步。
更新于:Suno Visuals 官方示例
Suno Video 能做什么
文生视频
描述场景,并设置时长、宽高比和分辨率。
帧与参考图控制
可从首帧开始、指定首尾帧,或使用最多 9 张参考图引导视频。
Suno 音频与口型同步
参考已有 Suno 歌曲并选择等长音频片段;口型同步需要 song_id。
两条视频输出
提交后通过 jobId 查询或接收回调,分别检查每条视频的状态和链接。
按操作计费,单位为 quota
按模型、操作和输出设置扣除 quota。
按请求时长计费,每次请求生成两条视频,费率已包含两条输出。
Suno Video 操作和请求字段
使用 TTAPI 密钥,按下方字段向接口发送请求。
/suno/v1/video/generate通过提示词和 5 至 15 秒的时长生成视频。
查看接口文档(英文文档)/suno/v1/video/generate以 first_frame_url 为首帧生成视频,也可添加参考图。
查看接口文档(英文文档)/suno/v1/video/generate使用 first_frame_url 和 last_frame_url,不与参考图组合。
查看接口文档(英文文档)/suno/v1/video/generate通过最多 9 张 reference_image_urls 参考图引导生成。
查看接口文档(英文文档)/suno/v1/video/generate添加 song_id 和可选的 song_window,按需启用 lip_sync。
查看接口文档(英文文档)/suno/v2/fetch把提交响应中的 data.jobId 作为查询参数 jobId。检查任务状态 ON_QUEUE、SUCCESS 或 FAILED,再查看 data.videos 中各条视频的 status 与 video_url。
查看接口文档(英文文档)请求头
TT-API-KEYstring必填具有 Suno Video 权限的 TTAPI API 密钥,生成与查询结果均需要。
Content-Typestring必填内容类型为 application/json。
请求体
promptstring必填描述场景、镜头运动和风格,长度为 1 至 30,000 个字符。
durationinteger必填请求视频时长为 5 至 15 秒,按此时长计费。
resolutionenum选填480p(快速,默认)或 720p(标准)。
aspect_ratioenum选填支持 1:1、9:16(默认)、16:9、4:3 或 3:4。
first_frame_urlstring选填公开可访问的 HTTP(S) 链接,指向不超过 10 MiB 的 JPEG 或 PNG。可单独使用,也可配合尾帧或参考图。
last_frame_urlstring选填公开可访问的 HTTP(S) 链接,指向不超过 10 MiB 的 JPEG 或 PNG。填写时须同时提供 first_frame_url,且不能与 reference_image_urls 并用。
reference_image_urlsstring[]选填最多 9 个公开可访问的 HTTP(S) 链接,指向 JPEG 或 PNG,每张不超过 10 MiB,可配合首帧使用。
song_idstring选填用于参考音频的 Suno 歌曲 ID,可与各类支持的图像输入组合。
song_windowobject选填填写时须提供 song_id。start_s 和 end_s 均为非负数,单位为秒,可以填写小数。start_s 默认为 0,end_s 默认为 start_s + duration,参考片段长度须等于 duration。
lip_syncboolean选填默认为 false。设为 true 时启用口型同步,并须提供 song_id。
hookUrlstring选填公开可访问的回调地址。完成后收到 HTTP POST,正文与视频 Fetch V2 查询响应相同。
发送请求并获取结果
复制当前模型的请求地址、鉴权请求头和请求体。
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"}'