白雲 API 教程：充值與餘額消費
Doken（DK）數量、0.30元/DK人民幣付款、支付寶微信與按用量消費。 附完整檢查步驟、實操驗證和錯誤處理。
充值與餘額消費
本站暫不推出會員訂閱計劃，只採用餘額消耗模式：充多少用多少，按實際模型調用扣費。 不設置用戶分組的額外倍率，也沒有充值檔位折扣。
人民幣付款，Doken 記餘額
1 詞刀（1 DK）=按選定商業 API 參考報價，價值 1 美元的那批 Token 用量。 英文全稱是 Doken，單位寫作 DK。 這是用量定義，不是平台實際支付了 1 美元訂閱費，也不等於可兌換 1 美元現金。
本站按這個單位記餘額和消費。 當前充值售價為 0.30 元/DK，10 DK 的充值金額為 3 元，100 DK 的充值金額為 30 元，另付下述支付通道費; 售價不等於未經實測的精確訂閱成本。 DK 不代表固定字數或 Token 數量。 想了解同一批 Token 怎樣從參考價值算到訂閱成本，再換人民幣或日元，可看三分鐘讀懂 Doken。
易支付上游收取充值金額的 5% 作為支付通道費。 預計實付=充值金額+支付通道費。 通道費由易支付上游收取，不計入 DK 餘額; 充值售價和到帳 DK 數量不變。
| 充值數量 | 充值金額（人民幣） | 支付通道費（5%） | 預計實付（人民幣） |
|---|---|---|---|
| 1 DK | ¥0.30 | ¥0.02 | ¥0.32 |
| 10 DK | ¥3.00 | ¥0.15 | ¥3.15 |
| 100 DK | ¥30.00 | ¥1.50 | ¥31.50 |
| 200 DK | ¥60.00 | ¥3.00 | ¥63.00 |
例如充值 200 DK：充值金額 60 元，支付通道費 3 元，預計實付 63 元，到賬仍為 200 DK。 表中金額按人民幣分展示，小額費用可能存在分幣捨入，最終實付以支付收銀台顯示為準。
錢包中的充值數量按 DK 填寫; 付款確認中的充值金額、支付通道費和預計實付都是人民幣。 當前最低充值數量為 1 DK。 請在下單前核對數量、預計實付和支付方式。
當前支付方式
當前接入支付寶、微信易支付通道，訂單按人民幣付款。 其他支付入口暫未開放。 歷史公告中的日元、港幣、美元固定報價屬於報價公示，不能據此理解為當前已經開放這些幣種的收款。
收款確認後依訂單狀態入帳。 如果已支付但餘額尚未更新，請先查看充值記錄與訂單狀態，保留訂單號和時間聯繫管理員; 不要反覆支付同一訂單，也不要把商戶或支付密鑰發給任何人。
調用怎樣扣費
模型單價區分輸入、輸出、快取與長上下文件位。 不同模型完成同樣問題，Token 數和消費可能不同; 價格以模型廣場及實際消費記錄為準。
例如某次調用按公示價格計得 0.2 DK，則餘額扣除約 0.2 DK; 按當前充值價，相當於使用了 0.2 × 0.30=0.06 元，也就是 6 分錢的已購餘額。 它不是額外再收一次人民幣。
每次請求的 Token 數和計價類別都會影響消費，不能承諾一句話固定花 0.2 DK，也不能用 1 DK 固定兌換某個字數。
快取優惠與長上下文件位是模型本身的計價類別，不是特殊用戶倍率。 本站分組倍率統一為 1。
報錯、攔截與取消
本地安全攔截的請求不進入上游，也不產生本次模型調用扣費。 進入上游後的正常請求及失敗請求，由系統預扣、結算和退款邏輯處理;客戶端取消、斷線或報錯並不統一等於零費用。 發生疑問時以消費記錄、請求編號與訂單記錄核對。
平台訂閱和你的餘額怎樣區分
平台核算成本時，應先按商業 API 參考價量出同一批 Token 的 DK，再根據 Codex 訂閱帳單與實際用量分攤美元成本，最後按明確匯率換成人民幣或日元。 它不能由當前 0.30 元/DK 的售價反推，也不能保證某筆訂閱費固定提供多少 DK。
你在本站購買的是 DK 餘額，沒有購買本站會員訂閱，也沒有因為平台的訂閱週期而新增按週或按月清零規則。
當前通俗說明見三分鐘讀懂 Doken。 完整的早期成本測算留在歷史公告存檔，其中舊估算不是當前額度保證。
當前用戶服務方式以本頁與使用規則為準。 價格或開放範圍變化時，會在公告與文章中公示。
實操前的檢查清單
- 準備自己的帳戶與呼叫金鑰，不使用他人的共享憑據。
- 記錄客戶端版本、系統和準備使用的模型，便於排查時復現。
- 儲存原配置或截圖，隱藏金鑰、驗證碼與私人內容。
- 確認測試可能消費少量 DK，先用一句話、一次請求開始。
- 查閱當前模型廣場與狀態頁，再決定是否啟用更多功能。
詳細排查：訂單創建不等於付款成功
先核對數量、本金、通道費和實付，再到真實收銀台完成付款。 頁面提示處理中時，核對支付賬戶實際扣款和本站訂單狀態; 不要不斷新建同一筆訂單。 未到帳時提交訂單號、時間與脫敏付款記錄，不提交支付密碼。
怎樣確認本節已經學會
不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議，能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。
如果出現錯誤，記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰，也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證，對 400 應先解決參數，對 429 應停止密集重試，對 404 應核對請求路徑與上游是否實現，不能用重新充值解決所有報錯。
一個適合練習的小任務
在自己的測試環境完成本節的最小步驟，用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能，先查看對應協議教程，再考慮添加功能; 一次只變更一個配置，容易判斷哪一步導致錯誤。
下一步與版本邊界
返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。
教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。