白雲 API 教程：CC Switch 接入指南
配置步驟、適用前提與常見相容問題。 附完整檢查步驟、實操驗證和錯誤處理。
CC Switch 接入指南
使用前準備
在金鑰管理單獨建立此工具專用的呼叫金鑰，確認帳戶已完善且 DK 餘額足夠。 客戶端版本會影響入口名稱，本頁按配置項說明; 以當前版本實際介面為準。
配置步驟
在當前版本中為 Codex 添加自訂供應商，將 Base URL 設為本站地址、模型設為模型廣場中的名稱，密鑰保存在本機私有配置。 預覽生成的配置，確認 Responses 協議後再切換; 最後重新啟動實際使用的 Codex。
| 配置項 | 填寫內容 |
|---|---|
| Base URL | https://api.baiyun.si/v1 |
| API Key | 此用戶端專用的呼叫金鑰 |
| 模型示例 | gpt-6-luna |
| 普通聊天協議 | OpenAI Compatible Chat Completions |
| Codex 供應商協議 | Responses |
最小驗證
先關閉聯網搜尋、圖片、附件、知識庫及自動執行工具，發送一句普通文本。 核對客戶端確實選用了本站供應商，再到用量日誌查看本次模型與消費。 客戶端連通性按鈕可能只檢查模型列表，不能替代一次真實聊天。
常見問題
地址要求完整 endpoint 時，Chat 地址應為 https://api.baiyun.si/v1/chat/completions； 要求 Base URL 時用表中地址。 出現 /v1/v1 或重複 /chat/completions 時先改地址。 401 核對密鑰與生效供應商; 429 停止並行測試後等待; 404 核對協議和模型，不要將不支援的協議偽裝成另一個模型。
能力與數據
本頁提供配置指引，未對每個客戶端版本完成真人全功能測試。 自訂模型不保證享有客戶端官方模型的補全、工具或訂閱功能。 第三方客戶端可能上傳會話或配置同步數據，使用前查看其隱私設置; 不要公開匯出含金鑰的配置。
實操前的檢查清單
- 準備自己的帳戶與呼叫金鑰，不使用他人的共享憑據。
- 記錄客戶端版本、系統和準備使用的模型，便於排查時復現。
- 儲存原配置或截圖，隱藏金鑰、驗證碼與私人內容。
- 確認測試可能消費少量 DK，先用一句話、一次請求開始。
- 查閱當前模型廣場與狀態頁，再決定是否啟用更多功能。
詳細排查：按順序縮小問題範圍
先確認帳戶已完善、密鑰有效、DK 餘額足夠，再核對協議、地址與模型。 用同一密鑰做一次最小文本請求; 它成功以後，才逐項恢復附件、工具或自動重試。 客戶端配置儲存後重新打開會話，避免舊會話仍使用先前供應商。
怎樣確認本節已經學會
不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議，能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。
如果出現錯誤，記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰，也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證，對 400 應先解決參數，對 429 應停止密集重試，對 404 應核對請求路徑與上游是否實現，不能用重新充值解決所有報錯。
一個適合練習的小任務
在自己的測試環境完成本節的最小步驟，用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能，先查看對應協議教程，再考慮添加功能; 一次只變更一個配置，容易判斷哪一步導致錯誤。
下一步與版本邊界
返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。
教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。