使用指南
- 使用此接口检查任务状态并访问生成结果
- 任务详情包括状态、参数和生成的曲目
- 生成的曲目可通过返回的URL访问
状态说明
PENDING: 任务等待处理中TEXT_SUCCESS: 歌词/文本生成成功FIRST_SUCCESS: 第一个音轨生成完成SUCCESS: 所有音轨生成成功CREATE_TASK_FAILED: 创建任务失败GENERATE_AUDIO_FAILED: 音频生成失败CALLBACK_EXCEPTION: 回调过程中出错SENSITIVE_WORD_ERROR: 内容因敏感词被过滤
开发者注意事项
- 对于纯音乐曲目(
instrumental=true),响应中不会包含歌词数据 - 最大查询频率:每个任务每秒最多3次请求
- 响应包括音频文件、图片和流式端点的直接URL
Authorizations
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key:
- 访问 API Key 管理页面 获取您的 API Key
使用方式: 在请求头中添加: Authorization: Bearer YOUR_API_KEY
注意事项:
- 请妥善保管您的 API Key,不要泄露给他人
- 如果怀疑 API Key 泄露,请立即在管理页面重置
Query Parameters
要获取的音乐生成任务的唯一标识符。可以是"生成音乐"任务或"延长音乐"任务返回的taskId。
Response
请求成功
响应状态码
- 200: 成功 - 请求已成功处理
- 401: 未授权 - 身份验证凭据缺失或无效
- 402: 积分不足 - 账户没有足够的积分执行此操作
- 404: 未找到 - 请求的资源或端点不存在
- 409: 冲突 - WAV记录已存在
- 422: 验证错误 - 请求参数未通过验证检查
- 429: 超出限制 - 已超过对此资源的请求限制
- 451: 未授权 - 获取图像失败。请验证您或您的服务提供商设置的任何访问限制。
- 455: 服务不可用 - 系统当前正在进行维护
- 500: 服务器错误 - 处理请求时发生意外错误
可用选项:
200, 401, 402, 404, 409, 422, 429, 451, 455, 500 当 code != 200 时的错误信息
Example:
"success"
