Suno Video

由 Suno 提供视频

通过 TTAPI 的 Suno Video API,使用 video-1 按文本、首尾帧或参考图生成 5 至 15 秒视频,支持 480p、720p、Suno 歌曲参考音频和口型同步。

更新于:
时长5 至 15 秒请求的视频时长
分辨率480p / 720p快速或标准
输出2 条视频每次生成请求
价格12 quota480p 每秒费率
视频示例视频预览
粉色毛绒歌手

穿着闪亮鞋子的粉色毛绒角色,在 Suno Visuals 音乐视频中表演。

video-1
生成示例

Suno Visuals 官方示例

模型能力

Suno Video 能做什么

文生视频

描述场景,并设置时长、宽高比和分辨率。

帧与参考图控制

可从首帧开始、指定首尾帧,或使用最多 9 张参考图引导视频。

Suno 音频与口型同步

参考已有 Suno 歌曲并选择等长音频片段;口型同步需要 song_id。

两条视频输出

提交后通过 jobId 查询或接收回调,分别检查每条视频的状态和链接。

计费

按操作计费,单位为 quota

按模型、操作和输出设置扣除 quota。

Suno 视频计费官方定价(英文文档)

按请求时长计费,每次请求生成两条视频,费率已包含两条输出。

分辨率价格计费单位
480p12 quota · $0.12 / 秒
720p24 quota · $0.24 / 秒
API 请求

Suno Video 操作和请求字段

使用 TTAPI 密钥,按下方字段向接口发送请求。

查询结果GET
/suno/v2/fetch

把提交响应中的 data.jobId 作为查询参数 jobId。检查任务状态 ON_QUEUE、SUCCESS 或 FAILED,再查看 data.videos 中各条视频的 status 与 video_url。

查看接口文档(英文文档)
POSThttps://api.ttapi.io/suno/v1/video/generate

请求头

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 查询响应相同。

查看 TTAPI 接入文档(英文文档)
接入示例

发送请求并获取结果

复制当前模型的请求地址、鉴权请求头和请求体。

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"}'