白雲 API 教程：快速開始
從登入、儲值和建立金鑰，到第一個純文字 API 請求。 附完整檢查步驟、實操驗證和錯誤處理。
快速開始
本頁幫助你從網站聊天或 API 調用開始使用本站。 當前服務範圍為完整、可檢查的純文本請求。
在網站體驗
- 註冊或登入本站帳戶。
- 打開錢包，確認 Doken（詞刀，DK）數量和人民幣實付金額後，通過支付寶或微信充值; 當前單價 0.30 元/DK。
- 打開聊天體驗，選擇已開放模型，先提交一條簡短、正常的文本問題。
- 在控制台查看用量與消費記錄。
當前按餘額消耗，不需要購買會員訂閱。 充值與調用前請閱讀使用規則。
為應用建立呼叫金鑰
在金鑰管理建立用於模型呼叫的 API 金鑰; 根據實際需求設置餘額與模型限制，保存後妥善保管。
應用使用的是模型調用密鑰，不是網頁登錄密碼。 不要把金鑰寫入公開程式碼、截圖、聊天內容或可被瀏覽器存取的前端程式碼。 已經洩露的密鑰應在密鑰管理中撤銷並重新建立。
配置用戶端
| 配置項 | 當前填寫內容 |
|---|---|
| API Base URL | https://api.baiyun.si/v1 |
| API Key | 在本站金鑰管理建立的呼叫金鑰 |
| 模型 | 例如 GPT-6-LUNA; 準確列表見模型廣場 |
| 介面 | Chat Completions 或 Responses 的文字模式 |
不同客戶端對地址的定義不同：填寫 Base URL 時通常保留 /v1； 如果要求填完整 Chat 地址，則填 https://api.baiyun.si/v1/chat/completions。 不要把 /v1 重複拼接兩次。 不能預設所有客戶端、外掛及功能都相容。
第一個 API 請求
在本機終端設置環境變數，輸入密鑰時避免進入共享終端或錄屏：
read -r -s -p '请输入本站 API 密钥：' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY
curl --fail-with-body https://api.baiyun.si/v1/chat/completions \
-H "Authorization: Bearer $BAIYUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-6-luna",
"messages": [{"role": "user", "content": "你好，请用一句话介绍你能帮我做什么。"}],
"stream": false
}'成功請求返回生成文本與用量資訊，並按公示參考單價扣除 DK 餘額。 1 DK 指按選定商業 API 參考報價價值 1 美元的那批 Token，不是固定 Token 數量或可兌換美元的現金。 上面的正常請求也會產生少量消費。
當前 0.30 元/DK 是本站充值售價，不是已經實測證明的精確訂閱成本; 同批 Token 的參考價值、訂閱成本與人民幣或日元換算見三步計費說明。
想持續接收輸出，查看Chat 流式示例； 應用使用 Responses 時，查看Responses 範例。
檢查可呼叫的模型
模型列表介面也需要密鑰鑑權：
curl --fail-with-body https://api.baiyun.si/v1/models \
-H "Authorization: Bearer $BAIYUN_API_KEY"以當前密鑰實際返回的模型為準。 若模型不存在或不可用，請核對模型名稱、密鑰限制和餘額，不要反覆重試不受支持的請求。
實操前的檢查清單
- 準備自己的帳戶與呼叫金鑰，不使用他人的共享憑據。
- 記錄客戶端版本、系統和準備使用的模型，便於排查時復現。
- 儲存原配置或截圖，隱藏金鑰、驗證碼與私人內容。
- 確認測試可能消費少量 DK，先用一句話、一次請求開始。
- 查閱當前模型廣場與狀態頁，再決定是否啟用更多功能。
詳細排查：按順序縮小問題範圍
先確認帳戶已完善、密鑰有效、DK 餘額足夠，再核對協議、地址與模型。 用同一密鑰做一次最小文本請求; 它成功以後，才逐項恢復附件、工具或自動重試。 客戶端配置儲存後重新打開會話，避免舊會話仍使用先前供應商。
怎樣確認本節已經學會
不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議，能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。
如果出現錯誤，記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰，也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證，對 400 應先解決參數，對 429 應停止密集重試，對 404 應核對請求路徑與上游是否實現，不能用重新充值解決所有報錯。
一個適合練習的小任務
在自己的測試環境完成本節的最小步驟，用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能，先查看對應協議教程，再考慮添加功能; 一次只變更一個配置，容易判斷哪一步導致錯誤。
下一步與版本邊界
返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。
教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。