错误处理

​

统一错误形状

{
  "error": {
    "kind": "invalid_input",
    "message": "请求参数校验失败：speech_text: ...",
    "retryable": false
  }
}

​

状态码与处理策略

​

domain 错误 kind 一览

​

重试建议

• 只重试 retryable: true 的错误（目前即 502）。
• request_id 保持不变，服务端按它幂等去重，重复提交安全。
• 重试仍失败时保留 request_id 与错误 body，便于对账排查。