参数选择逻辑
- audioId 参数:
- audioId 参数为必需参数,用于标识确切的曲目
- 为生成任务中的音频轨道提供唯一标识符
开发者注意事项
- 时间戳值以秒为单位
- 返回的波形数据可用于音频可视化
- 对于纯音乐曲目(使用 instrumental=true 生成的),将没有歌词数据
- 典型用例:音乐播放器界面中的卡拉OK式歌词显示
Authorizations
🔑 API 认证说明
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key
- 访问 API Key 管理页面 获取您的 API Key
使用方式
在请求头中添加:
Authorization: Bearer YOUR_API_KEY⚠️ 注意:
- 请妥善保管您的 API Key,不要泄露给他人
- 如果怀疑 API Key 泄露,请立即在管理页面重置
Body
application/json
Response
请求成功
状态码说明
- ✅ 200 - 请求成功
- ⚠️ 400 - 参数错误
- ⚠️ 401 - 没有访问权限
- ⚠️ 404 - 请求方式或者路径错误
- ⚠️ 405 - 调用超过限制
- ⚠️ 413 - 主题或者prompt过长
- ⚠️ 429 - 积分不足
- ⚠️ 430 - 您的调用频率过高,请稍后再试。
- ⚠️ 455 - 网站维护
- ❌ 500 - 服务器异常
可用选项:
200, 400, 401, 404, 405, 413, 429, 430, 455, 500 Example:
200
当 code != 200 时,展示错误信息
Example:
"success"
