Skip to main content
POST
cURL
这是 Producer API 的核心音乐生成接口。 如果你想查看完整的接口目录、推荐接入流程和相关能力,请先阅读 Producer API 总览

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
sound_prompt
string
必填

音频提示词,sound_prompt与lyrics_text不可同时为空

lyrics_text
string
必填

歌词文本,sound_prompt与lyrics_text不可同时为空

instrumental
boolean
默认值:false

是否生成纯音乐,true 为生成纯音乐,true的情况下会忽略自定义歌词

mv
enum<string>
默认值:FUZZ-2.0

使用模型,支持范围

可用选项:
FUZZ-2.0 Pro,
FUZZ-2.0,
FUZZ-2.0 Raw,
FUZZ-1.1 Pro,
FUZZ-1.0 Pro,
FUZZ-1.0,
FUZZ-1.1,
FUZZ-0.8,
Lyria 3 preview,
Lyria 3 Pro
title
string

标题

cover_art_url
string

封面url

seed
string

随机种子

lyrics_strength
number
默认值:0.5

歌词强度,表示歌词在音频生成中的影响程度,可选0-1之间

sound_strength
number
默认值:0.5

音频提示词强度,可选0.2-1之间

weirdness
number
默认值:0.5

风格奇特度,可选 0-1之间

is_storage
boolean
默认值:false

是否转存 true-转存 false-不转存

hook_url
string

回调通知地址,当设置此参数,任务成功或者失败降会向该地址发送一个post请求,携带数据与查询任务结果中返回一致

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填
示例:
最后修改于 2026年4月26日