Skip to main content
POST
cURL
  • 当 is_async = false(同步模式)时: 接口会阻塞等待处理完成,并直接返回 music_id。 ⚠️ 由于需要等待完整处理流程,接口耗时较长。
  • 当 is_async = true(异步模式)时: 接口会立即返回 jobId。 你需要通过 jobId 调用查询任务接口,异步获取最终的上传结果。

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
audio_url
string
必填

音频地址,必须是可公开访问的音频地址

is_async
boolean
默认值:false

是否异步

  • false:同步等待

  • true:异步查询

hookUrl
string

回调通知地址

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填

使用同步上传(is_async=false),接口将同步等待返回音频id,接口耗时时间久

示例:
最后修改于 2026年3月21日