錯誤碼、鑑權、限流、暫封、接口與費用問題的排查方法。 附完整檢查步驟、實操驗證和錯誤處理。

常見錯誤與 429

遇到錯誤先查看 HTTP 狀態、返回的 error.message、error.code 和請求編號。 相同狀態碼可能來自不同環節，僅憑數字不能確認根因。

常見狀態

餘額不足、模型不可用、價格未配置等業務錯誤也要讀取返回正文，不能只看狀態碼或前端彈窗。

429 不一定是你“請求太多”

429 表示某一層限制了請求。 當前每個憑據最多同時進行 2 個請求，模型調用頻率限制為 每分鐘 60 次； 上游還有自己的資源與用量限制。

• concurrency_limit：等待已有請求完成，再發下一個。 流式請求在結束前仍佔用並發。
• 普通頻率限制或上游 429：尊重 Retry-After（若有），採用有限次數、逐步延長等待的重試，避免立即重複請求。
• 頁面直接顯示 HTTP ERROR 429：瀏覽器頁面請求也可能受限制; 稍等再刷新，持續發生時保留發生時間和路徑給管理員。

正常文本問題遭誤判時，可提供請求編號和必要的非敏感說明供複核; 不要發送可用金鑰、密碼或完整敏感原文。

403 與憑據暫封

content_policy_violation 表示本次請求命中本站使用限制，已在發送上游前拒絕。

credential_temporarily_blocked 返回 403，並提供 Retry-After 等待提示：同一憑據在 30 分鐘內多次命中使用規則後，暫停 30 分鐘。 請停止相關內容並等待恢復，不通過更換密鑰繼續嘗試。 這與 429 並發或頻率限制是不同原因。

介面地址和模型問題

Base URL 應為 https://api.baiyun.si/v1，完整 Chat 地址為 /v1/chat/completions，Responses 地址為 /v1/responses。 檢查是否出現重複 /v1/v1，以及客戶端是否選擇了本站未開放的協議。

模型名稱必須與模型廣場及當前密鑰的 /v1/models 返回一致，不要用客戶端的顯示別名代替真正的呼叫名稱。

流式和費用問題

Chat SSE 應讀取到 [DONE]； Responses SSE 應讀取完整結束事件。 網路斷線後的部分文本不能當作完整成功回應。

輸入輸出參數並不保證費用硬上限。 正常請求、進入上游後的失敗或客戶端取消，需結合實際消費記錄核對; 只有在本地拒絕且未進入上游的請求不產生本次模型調用扣費。

排查時提供什麼

1. 發生時間與時區。
2. 請求編號、模型名稱、介面路徑及 HTTP 狀態。
3. 去掉金鑰和敏感內容後的錯誤資訊。
4. 支付問題另外提供訂單號與狀態，不提供支付商戶密鑰。

本站仍在逐步完善，暫未承諾全天候人工響應或固定處理時限。

實操前的檢查清單

1. 準備自己的帳戶與呼叫金鑰，不使用他人的共享憑據。
2. 記錄客戶端版本、系統和準備使用的模型，便於排查時復現。
3. 儲存原配置或截圖，隱藏金鑰、驗證碼與私人內容。
4. 確認測試可能消費少量 DK，先用一句話、一次請求開始。
5. 查閱當前模型廣場與狀態頁，再決定是否啟用更多功能。

詳細排查：按順序縮小問題範圍

先確認帳戶已完善、密鑰有效、DK 餘額足夠，再核對協議、地址與模型。 用同一密鑰做一次最小文本請求; 它成功以後，才逐項恢復附件、工具或自動重試。 客戶端配置儲存後重新打開會話，避免舊會話仍使用先前供應商。

怎樣確認本節已經學會

不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議，能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。

如果出現錯誤，記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰，也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證，對 400 應先解決參數，對 429 應停止密集重試，對 404 應核對請求路徑與上游是否實現，不能用重新充值解決所有報錯。

一個適合練習的小任務

在自己的測試環境完成本節的最小步驟，用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能，先查看對應協議教程，再考慮添加功能; 一次只變更一個配置，容易判斷哪一步導致錯誤。

下一步與版本邊界

返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。

教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。