状态说明
- PENDING: 任务正在等待处理
- TEXT_SUCCESS: 歌词/文本生成已成功完成
- FIRST_SUCCESS: 第一首曲目生成已成功完成
- SUCCESS: 所有曲目已成功生成
- CREATE_TASK_FAILED: 创建生成任务失败
- GENERATE_AUDIO_FAILED: 生成音乐曲目失败
- CALLBACK_EXCEPTION: 回调过程中发生错误
- SENSITIVE_WORD_ERROR: 内容包含禁用词
开发者注意事项
- 对于纯音乐曲目(instrumental=true),响应中不会包含歌词数据
- 可以使用此接口检查任务状态,而不必等待回调
Authorizations
🔑 API 认证说明
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key
- 访问 API Key 管理页面 获取您的 API Key
使用方式
在请求头中添加:
Authorization: Bearer YOUR_API_KEY
⚠️ 注意:
- 请妥善保管您的 API Key,不要泄露给他人
- 如果怀疑 API Key 泄露,请立即在管理页面重置
Query Parameters
从'生成音乐'或'延长音乐'接口返回的任务ID。用于标识要查询的特定生成任务。
Response
请求成功
状态码说明
- ✅ 200 - 请求成功
- ⚠️ 400 - 参数错误
- ⚠️ 401 - 没有访问权限
- ⚠️ 404 - 请求方式或者路径错误
- ⚠️ 405 - 调用超过限制
- ⚠️ 413 - 主题或者prompt过长
- ⚠️ 429 - 积分不足
- ⚠️ 430 - 您的调用频率过高。请稍后再试。
- ⚠️ 455 - 网站维护
- ❌ 500 - 服务器异常
Available options:
200
, 400
, 401
, 404
, 405
, 413
, 429
, 430
, 455
, 500
Example:
200
当 code != 200 时,展示错误信息
Example:
"success"