Skip to main content
POST
cURL
  • 当 is_async = false(同步模式)时: 接口会阻塞等待处理完成,并直接返回 music_id。 ⚠️ 由于需要等待完整处理流程,接口耗时较长。仅支持 upload_mode=default。
  • 当 is_async = true(异步模式)时: 接口会立即返回 jobId。 你需要通过 jobId 调用查询任务接口,异步获取最终的上传结果。
  • upload_mode:上传模式,未传时默认为 default。
    • default:默认上传,定价 0.5 quota,支持同步或异步。
    • enhanced:增强上传,可降低失败率,定价 1 quota,必须使用异步(is_async=true)。
定价详见 音频模型定价。

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
audio_url
string
必填

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

is_async
boolean
默认值:false

是否异步

  • false:同步等待

  • true:异步查询

当 upload_mode=enhanced 时必须为 true。

upload_mode
enum<string>
默认值:default

上传模式。

  • default:默认,定价 0.5 quota
  • enhanced:增强,可降低失败率,定价 1 quota。仅支持异步,必须配合 is_async=true 使用
可用选项:
default,
enhanced
hookUrl
string

回调通知地址

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填

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

示例:
最后修改于 2026年9月16日