白雲 API 教程:如何讀懂狀態監控
即時閘道檢查、模型歷史成功率、沒有樣本與故障判斷。 附完整檢查步驟、實操驗證和錯誤處理。
如何讀懂狀態監控
查看狀態頁
狀態監控提供閘道偵測、回應耗時及模型請求歷史。 頁面自動刷新,可手動刷新; 數據暫時取不到時顯示未知或過期,不會預設全部正常。
閘道檢查
後台每分鐘檢測本閘道的公開健康介面並記錄最近 60 次。 檢測成功說明閘道能夠回應,不等於所有模型或上游都能成功生成。 這裡的延遲是健康介面耗時,不是模型首字或完整生成耗時。
模型請求歷史
模型卡片來自本站原生統計的真實請求; 顯示最近 24 小時成功率、平均回應耗時和每小時色條。 有失敗會顯示部分異常或異常; 灰色小時表示沒有記錄,不能計入成功率,也不表示停機。 長時間沒有新請求時顯示「暫無近期樣本」,不據此保證當前可用。
如何排查
閘道正常但模型異常時,先換一條最小文本請求,核對密鑰、餘額、參數與上游情況。 歷史失敗包含不同請求條件,不能直接當作獨立探針可用率。 閘道偵測異常時,保留時間和錯誤,並稍後再次查看。
狀態頁不是 SLA 承諾,也不會觸發付費模型輪詢或收集你的提示詞。 完整消費信息僅在本人控制台查看。
實操前的檢查清單
- 準備自己的帳戶與呼叫金鑰,不使用他人的共享憑據。
- 記錄客戶端版本、系統和準備使用的模型,便於排查時復現。
- 儲存原配置或截圖,隱藏金鑰、驗證碼與私人內容。
- 確認測試可能消費少量 DK,先用一句話、一次請求開始。
- 查閱當前模型廣場與狀態頁,再決定是否啟用更多功能。
詳細排查:灰色不是失敗,綠色也不是保證
先讀數據更新時間。 閘道最近一次成功只證明該檢查介面可存取; 模型統計來自已發生的真實請求。 有樣本的時間段才參與模型歷史成功率,空白時間不能補成成功。 歷史失敗也可能與參數、網路或上游有關,結合自己請求的錯誤碼分析。
怎樣確認本節已經學會
不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議,能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。
如果出現錯誤,記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰,也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證,對 400 應先解決參數,對 429 應停止密集重試,對 404 應核對請求路徑與上游是否實現,不能用重新充值解決所有報錯。
一個適合練習的小任務
在自己的測試環境完成本節的最小步驟,用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能,先查看對應協議教程,再考慮添加功能; 一次只變更一個配置,容易判斷哪一步導致錯誤。
下一步與版本邊界
返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。
教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。