视频教程Suno Video API

Suno Video API 接入指南:价格、歌曲参考与口型同步

了解 TTAPI 的 Suno Video API:5 至 15 秒视频、480p 与 720p 价格、参考图、Suno 歌曲和口型同步,以及异步结果查询。

TTAPI约 5 分钟阅读
Suno Visuals 官方发布拼图Suno Video · API 价格与口型同步
本文导读

你将了解

  • 估算一次请求两条视频的费用
  • 选择文本、首尾帧、参考图或歌曲音频
  • 提交任务并获取两条视频结果
要点

Suno Video 可生成 5 至 15 秒视频,支持歌曲参考音频和口型同步。按请求秒数估算费用,一次请求的价格已包含两条输出。可用首尾帧或参考图引导画面,再通过 Fetch V2 分别检查结果。

Suno Video 接入 TTAPI

TTAPI 于 2026 年 11 月 20 日新增 Suno Video,模型标识为 video-1。生成接口支持文本、首帧图、首尾帧和参考图,每次请求指定 5 至 15 秒,输出可选 480p 或 720p。

需要围绕音乐创作时,可以添加已有 Suno 歌曲作为参考音频,并按需开启口型同步。可用于尝试歌曲预告、角色表演和短视频创作;正式采用前,仍需按自己的创作要求检查生成结果。

Suno Visuals 官方宣传展示,时长超过单次 API 片段,原始参数未公开。
打开视频文件

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。

Suno Video 请求费用估算
分辨率每秒5 秒请求10 秒请求15 秒请求
480p12 quota · $0.12 / 秒60 quota · $0.60120 quota · $1.20180 quota · $1.80
720p24 quota · $0.24 / 秒120 quota · $1.20240 quota · $2.40360 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 密钥。

提交 5 秒视频任务
bash
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;这是一份请求模板,并非实际生成记录。

参考歌曲片段并启用口型同步
bash
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 响应相同。保存结果链接,并对重复通知去重。

查询 Suno Video 任务
bash
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 相同。
  • 检查两条视频的状态以及任务扣费。
继续接入

查看 Suno Video

打开模型页,查看模型 ID、请求示例和当前价格。