跳转到主要内容
POST
/
producer
/
v1
/
music
cURL
curl --request POST \
  --url https://api.ttapi.io/producer/v1/music \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "sound_prompt": "<string>",
  "lyrics_text": "<string>",
  "instrumental": "false",
  "mv": "FUZZ-2.0",
  "title": "<string>",
  "cover_art_url": "<string>",
  "seed": "<string>",
  "lyrics_strength": "0.5",
  "sound_strength": "0.5",
  "weirdness": "0.5",
  "is_storage": "false",
  "hook_url": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

这是 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
必填
示例:
{ "job_id": "job_id" }
Last modified on March 26, 2026