統一地址、協議選擇、最小請求與相容範圍。 附完整檢查步驟、實操驗證和錯誤處理。

OpenAI Compatible 接入

三項核心配置

Chat Completions 與 Responses 是兩種請求協議，不是兩種密鑰。 普通聊天客戶端一般使用 Chat; Codex 自訂供應商使用 Responses。 模型列表與價格以模型廣場的實際公示為準。

先驗證模型列表

curl --fail-with-body https://api.baiyun.si/v1/models   -H "Authorization: Bearer $BAIYUN_API_KEY"

BAIYUN_API_KEY 是你在本機私下設置的環境變數，不要把真實值寫進教程、代碼倉庫或截圖。 401 先檢查密鑰，404 先檢查地址，429 先等待，不要無限重試。

再發最小文本請求

curl --no-buffer --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":true}'

流式請求逐段返回。 能列出模型不代表已經成功生成; 能生成普通文本也不代表圖片、音訊、檔案、搜尋或全部工具都可用。 先保持最小設定，再按本站實際開放範圍逐項啟用功能。

參數與能力邊界

不要把客戶端自動補上的 tools、圖片、附件或歷史引用都當成通用能力。 當前 Codex 通路有專門適配，普通客戶端仍應先用純文字。 上下文壓縮路徑已開放，但上游此前返回過 404;遇到該錯誤時不能靠反覆換密鑰修復。

實操前的檢查清單

1. 準備自己的帳戶與呼叫金鑰，不使用他人的共享憑據。
2. 記錄客戶端版本、系統和準備使用的模型，便於排查時復現。
3. 儲存原配置或截圖，隱藏金鑰、驗證碼與私人內容。
4. 確認測試可能消費少量 DK，先用一句話、一次請求開始。
5. 查閱當前模型廣場與狀態頁，再決定是否啟用更多功能。

詳細排查：按順序縮小問題範圍

先確認帳戶已完善、密鑰有效、DK 餘額足夠，再核對協議、地址與模型。 用同一密鑰做一次最小文本請求; 它成功以後，才逐項恢復附件、工具或自動重試。 客戶端配置儲存後重新打開會話，避免舊會話仍使用先前供應商。

怎樣確認本節已經學會

不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議，能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。

如果出現錯誤，記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰，也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證，對 400 應先解決參數，對 429 應停止密集重試，對 404 應核對請求路徑與上游是否實現，不能用重新充值解決所有報錯。

一個適合練習的小任務

在自己的測試環境完成本節的最小步驟，用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能，先查看對應協議教程，再考慮添加功能; 一次只變更一個配置，容易判斷哪一步導致錯誤。

下一步與版本邊界

返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。

教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。