错误码

错误结构

{
  "error": {
    "code": "invalid_audio_format",
    "message": "Unsupported audio encoding: mp3 over websocket",
    "request_id": "req_01J8..."
  }
}

反馈问题时请附上 request_id，我们可以据此定位。

常见错误码

code	HTTP	处理建议
unauthorized	401	检查 API Key 是否正确、是否已过期
quota_exceeded	429	已超出并发或额度上限，稍后重试或联系我们扩容
invalid_audio_format	400	实时接口仅接受 PCM，压缩格式请先解码
glossary_not_found	404	检查 glossary_id，注意测试与生产环境不互通
session_expired	410	重连间隔超过 5 分钟，需新建会话

重试策略

429 与 5xx 建议指数退避重试；4xx 的其他错误重试无意义，请先修正请求。