跳转到主要内容
POST
/
suno
/
v1
/
create-voice
cURL
curl --request POST \
  --url https://api.ttapi.io/suno/v1/create-voice \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "audio_url": "<string>",
  "hookUrl": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

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.

Create Voice 为异步任务接口。提交请求后不会立即返回生成结果，你可以通过以下方式获取结果：
  • 设置 hookUrl，任务完成后系统会向该地址发送 回调通知
  • 或调用 fetch 接口 主动查询任务状态和结果
如果使用 hookUrl，请确保该地址为公网可访问地址，否则可能无法接收回调通知。
  1. 上传的音频必须包含清晰的人声，否则可能导致创建失败。
请注意以下要求：
  • 音频中必须为清晰的人声
  • 避免包含背景噪音、音乐或回声
  • 不要包含多个说话人
  • 人声过小、不清晰或存在杂音，可能导致生成失败或效果较差
  1. 由于创建的语音为非公开资源（Private Voice），存在以下使用限制：
  • 不支持跨账号使用语音
  • 语音创建成功后，请及时使用，否则可能会失效或无法调用
建议在语音创建成功后尽快完成相关任务，以避免资源失效。
推荐音频要求：
  • 音频时长：大于 10 秒
  • 说话人：单人
  • 录制环境：安静无杂音
  • 音频格式：WAV 或 MP3

授权

​
TT-API-KEY
string
header
必填

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

请求体

application/json
​
audio_url
string
必填

音频链接，必须是可公开访问的音频地址，音频文件仅支持 MP3 和 WAV 格式。

​
hookUrl
string

回调通知地址

响应

请求成功

​
status
string
必填
示例:

"SUCCESS"

​
message
string
必填
示例:

"success"

​
data
object
必填
示例:
{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Last modified on March 29, 2026