瀏覽文件目錄

錯誤碼

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,開一條新串流。

每條會話結束時,按有效音訊時長向上取整到整分鐘;斷線重開分別計費,沒有有效音訊不收費。