错误码
HTTP 错误返回带 code 字段的 JSON。只重试标记为 retryable 的。
HTTP 错误
| 错误码 | HTTP | 含义 |
|---|---|---|
UNAUTHORIZED | 401 | API Key 缺失、格式不对,或已撤销。 |
INVALID_INPUT | 400 | 请求体格式不对。 |
INSUFFICIENT_BALANCE | 402 | 余额不够,开不了新流。 |
CONCURRENCY_LIMIT | 429 | 达到账号总并发(所有 Key 共用)、全局上限,或某个区域池的份额。没有按 Key 单独限额。 |
NOT_FOUND | 404 | 这个用户下没有这条录音或流。 |
ADMISSION_DISABLED | 503 | 这个部署关掉了 API 准入。 |
REGION_UNAVAILABLE | 503 | 请求的区域没有健康节点。未指定 region 时,表示所有区都不可用。 |
WebSocket 关闭码
所有可重试的关闭码对应同一个动作:重新调用 connect,开一条新流。不存在保留原流的续连路径。
| 关闭码 | 含义 | 怎么处理 |
|---|---|---|
4001 | Token 无效或已过期 | 重新调用 connect,换一张新 token。 |
4003 | sessionId 对不上 | 不要重试。先改客户端。 |
4004 | 这场不在这台节点上 | 重新调用 connect,换一个新地址。 |
4010 | 余额用完 | 先充值,再重新调用 connect。 |
4011 | 并发已满 | 等一会儿再重新调用 connect。 |
1003 | 协议错误 | 不要重试。先改客户端。 |
1012 | 网关正在重启 | 重新调用 connect,换一个新地址。 |
4012 | 达到最长时长(4 小时) | 重新调用 connect,开一条新流。 |
4013 | 空闲超时:连续 60 秒没有音频。Ping 不会重置它。 | 继续发音频,或重新调用 connect。 |
4014 | 计费没有确认 | 等账号可以扣费后,再重新调用 connect。 |
4015 | API Key 已撤销 | 新建一把 Key,再重新调用 connect。 |
4016 | 客户端读得太慢 | 重新调用 connect,开一条新流。 |
每条会话结束时,按有效音频时长向上取整到整分钟;断线重开分别计费,没有有效音频不收费。