ListenHubOpenAPI
EN中文

错误处理

错误码速查与排查建议。

ListenHub API 所有响应都使用 HTTP 200 状态码。通过响应体中的 code 字段区分成功与失败：code = 0 表示成功，code ≠ 0 表示失败。

错误码速查表

错误码说明处理建议
0请求成功—
21007API Key 无效检查 Authorization 头格式是否为 Bearer $LISTENHUB_API_KEY，确认 API Key 已正确复制
25002资源不存在检查 episodeId 是否正确
25008单集状态不正确仅在「先审后录」流程中出现。需等待文稿生成完成后再提交音频合成，详见播客 API 文档
26004积分不足调用 GET /v1/user/subscription 查询余额，前往积分购买页面充值
29003参数错误检查请求参数是否符合 API 文档要求
29998请求过于频繁已超出 3 RPM 限制，实现退避重试
91001内容过短增加输入内容长度
91002内容违规检查内容是否符合平台规范
91003-91007内容生成错误查看 message 字段获取具体错误信息

未列举的其他非 0 错误码：请查看响应中的 message 字段获取详情，或联系 support@marswave.ai。

错误响应格式

所有错误响应遵循相同的 JSON 格式：

{
  "code": 21007,
  "message": "Invalid API key",
  "data": null
}

常见排查步骤

API Key 问题（21007）：

  1. 确认 Authorization 头格式为 Bearer $LISTENHUB_API_KEY（注意 Bearer 后有空格）
  2. 确认 API Key 完整复制，无多余空格
  3. 前往 API Key 设置页面 确认 Key 状态

频率限制（29998）：

  1. 创建请求限制为每分钟 3 次（3 RPM）
  2. 查询请求不受此限制
  3. 实现指数退避重试策略

下一步

On this page

错误码速查表错误响应格式常见排查步骤下一步