音潮开放平台
开始使用错误代码

错误代码

以下为常见 API 错误码说明,建议在客户端按错误码做可恢复处理和重试策略。

错误码含义处理建议
400请求参数不正确请参考文档以输入正确的请求参数
401认证无效请确保使用正确的API Key
402账户余额不足请先充值后重试
404请求的内容未找到请参考文档以输入正确的请求参数
422请求参数不正确请参考文档以输入正确的请求参数
429任务的并发数达到上限请稍后重试
451参数没有通过安审请修改请求参数
500我们的服务出现了问题稍后重试您的请求,如果问题仍然存在,请联系我们

建议重试策略

  • 429500 使用重试。
  • 首次重试建议延迟 1 秒,后续按 2 倍递增,最多重试 3 次。
  • 400401 这类错误不要盲目重试,应先修正请求。

错误响应示例

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
  "detail": "Invalid API Key"
}