浏览文档目录

错误码

HTTP 错误返回带 code 字段的 JSON。只重试标记为 retryable 的。

HTTP 错误

错误码HTTP含义
UNAUTHORIZED401API Key 缺失、格式不对,或已撤销。
INVALID_INPUT400请求体格式不对。
INSUFFICIENT_BALANCE402余额不够,开不了新流。
CONCURRENCY_LIMIT429达到账号总并发(所有 Key 共用)、全局上限,或某个区域池的份额。没有按 Key 单独限额。
NOT_FOUND404这个用户下没有这条录音或流。
ADMISSION_DISABLED503这个部署关掉了 API 准入。
REGION_UNAVAILABLE503请求的区域没有健康节点。未指定 region 时,表示所有区都不可用。

WebSocket 关闭码

所有可重试的关闭码对应同一个动作:重新调用 connect,开一条新流。不存在保留原流的续连路径。

关闭码含义怎么处理
4001Token 无效或已过期重新调用 connect,换一张新 token。
4003sessionId 对不上不要重试。先改客户端。
4004这场不在这台节点上重新调用 connect,换一个新地址。
4010余额用完先充值,再重新调用 connect。
4011并发已满等一会儿再重新调用 connect。
1003协议错误不要重试。先改客户端。
1012网关正在重启重新调用 connect,换一个新地址。
4012达到最长时长(4 小时)重新调用 connect,开一条新流。
4013空闲超时:连续 60 秒没有音频。Ping 不会重置它。继续发音频,或重新调用 connect。
4014计费没有确认等账号可以扣费后,再重新调用 connect。
4015API Key 已撤销新建一把 Key,再重新调用 connect。
4016客户端读得太慢重新调用 connect,开一条新流。

每条会话结束时,按有效音频时长向上取整到整分钟;断线重开分别计费,没有有效音频不收费。