白雲 API 教程:用量、日誌與費用核對
用量單位、快取、實際消費及異常核查。 附完整檢查步驟、實操驗證和錯誤處理。
用量、日誌與費用核對
三個不同的數字
Token 是模型處理的用量單位; DK 是本站餘額與參考計價單位; 人民幣是充值實際付款幣種。 1 DK 對應按選定商業 API 參考價量出的 1 美元那批 Token,不固定 Token 個數,不能兌換美元。
從一條記錄開始
在用量日誌限定調用時間,核對模型、輸入、輸出、快取、耗時與實際扣款。 一次客戶端操作可能發出多條請求; Agent 的多輪工具調用也可能分別計費。 不要只用介面顯示的最後一句話長度估算全部用量。
模型與上下文價格
價格以模型廣場為準。 不同模型、輸入、輸出、快取和上下文件位可能採用不同費率。 工具沒有顯示快取欄位時,也應查看服務端用量記錄,不把快取當成所有輸入免費。
充值核對
當前本金按 0.30 元/DK 換算,支付通道費按收銀台顯示; 例如購買 10 DK,本金 3 元,加 5% 通道費為 3.15 元。 最後以訂單頁面實際金額為準。 通道費不進入 DK 餘額,訂單創建不代表已經付款到帳。
遇到異常
記錄時間、模型、脫敏請求資訊和訂單號,核對是否重複發送、自動重試或同時運行了其他客戶端。 不要提交完整金鑰、密碼或驗證碼。 餘額不足應充值或停止調用,不要嘗試用上游額度重置替代本站餘額。
實操前的檢查清單
- 準備自己的帳戶與呼叫金鑰,不使用他人的共享憑據。
- 記錄客戶端版本、系統和準備使用的模型,便於排查時復現。
- 儲存原配置或截圖,隱藏金鑰、驗證碼與私人內容。
- 確認測試可能消費少量 DK,先用一句話、一次請求開始。
- 查閱當前模型廣場與狀態頁,再決定是否啟用更多功能。
詳細排查:一輪操作可能有多條請求
客戶端自動總結、標題生成、重試、Agent 工具輪次都會增加請求。 先記錄測試開始和結束時間,用對應區間對照日誌。 檢查是否同時開著多個客戶端,避免把其他程式的用量算成當前一次呼叫。
怎樣確認本節已經學會
不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議,能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。
如果出現錯誤,記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰,也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證,對 400 應先解決參數,對 429 應停止密集重試,對 404 應核對請求路徑與上游是否實現,不能用重新充值解決所有報錯。
一個適合練習的小任務
在自己的測試環境完成本節的最小步驟,用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能,先查看對應協議教程,再考慮添加功能; 一次只變更一個配置,容易判斷哪一步導致錯誤。
下一步與版本邊界
返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。
教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。