跳转到主要内容

​
接口

POST /api/v1/music/upload
同步接口。 上传完成后立即返回片段元数据。 提供音频文件的外部 URL（MP3、WAV 等），上传后返回 clipId，可用于 添加伴奏 或 哼唱生成 等操作。

​
请求参数

字段类型是否必填说明
audio_urlstring必填音频文件的可公开访问 URL

​
响应

{
  "code": 0,
  "message": "ok",
  "request_id": "req-1710000000000",
  "data": {
    "clipId": "abc123def456",
    "audioUrl": "https://cdn.example.com/audio/abc123def456.mp3",
    "duration": 30,
    "status": 1
  }
}
字段类型说明
clipIdstring后续操作使用的片段 ID
audioUrlstring处理后的音频 URL
durationinteger音频时长（秒）
statusinteger上传状态码，1 = 就绪

​
示例

curl -X POST https://api.example.com/api/v1/music/upload \
  -H "Authorization: Bearer sk-mm-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/vocals.mp3"
  }'