跳转到主要内容
POST

输入方式

图片链接须可通过公网 HTTP(S) 访问。支持 JPEG 和 PNG,每张最多 10 MiB。 任意一种生成方式都可以添加 Suno 参考音频。传入 song_id 后,可用 song_window.start_s 和 song_window.end_s 指定参考区间,区间长度须等于 duration。不传时间区间时,从歌曲开头截取所需时长。lip_sync: true 需要提供 song_id。

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
prompt
string
必填

描述画面、镜头运动和风格。

Required string length: 1 - 30000
duration
integer
必填

生成时长,单位为秒。

必填范围: 5 <= x <= 15
resolution
enum<string> | null
默认值:480p

输出分辨率。480p 对应 fast,720p 对应 standard。

可用选项:
480p,
720p
aspect_ratio
enum<string> | null
默认值:9:16

画面宽高比

可用选项:
1:1,
9:16,
16:9,
4:3,
3:4
first_frame_url
string<uri>

首帧图的公网 HTTP(S) URL。可单独使用、与尾帧组合或与参考图组合。

last_frame_url
string<uri>

尾帧图的公网 HTTP(S) URL。需要同时传首帧;首尾帧组合不支持参考图。

reference_image_urls
string<uri>[]

最多 9 张,可单独使用或与首帧组合。

Maximum array length: 9

参考图的公网 HTTP(S) URL。

song_id
string

参考音频的 Suno 歌曲 ID,可与图片输入组合。

song_window
object

参考音频区间,使用时须传 song_id。省略时使用从第 0 秒起、长度与视频相同的片段。

lip_sync
boolean
默认值:false

开启口型同步。设为 true 时须传 song_id。

hookUrl
string<uri>

可选的 Webhook 回调地址。任务结束后通过 HTTP POST 发送,正文与视频任务 Fetch V2 响应一致。

响应

任务已受理。用 data.jobId 查询处理结果。

status
enum<string>
必填
可用选项:
SUCCESS
message
string
必填

受理提示。

data
object
必填
最后修改于 2026年11月20日