Skip to main content
NexusAPI 支援常用 AI 用戶端與 OpenAI 風格 API。不同工具可能會自行補上路徑，因此請依實際使用方式填寫位址；不要把某一個工具的整段設定直接複製到另一個工具。

​
開始前準備

不論採用哪一種接入方式，請先確認：
  1. 已在控制台建立 API Key。
  2. 該 API Key 所屬群組包含目標模型。
  3. 已從模型廣場複製正確的模型 ID。
  4. 已確認目標模型支援的介面類型，並以 HTTPS 位址發出請求。

​
常見使用方式

​
位址與協定對照

此表用於協助選擇接入方式。請先查看介面與模型能力矩陣確認模型和協定；欄位級參數與回應格式請看 Chat Completions 介面。特定 Key 與模型的即時可用性仍以模型廣場為準。

​
先選擇正確的協定

相同 Base URL 不代表所有模型都接受同一種請求格式。請依使用情境選擇：
不要把 Responses 當成通用替代介面若模型的 supported_endpoint_types 未包含 openai-response，卻透過 /v1/responses 回傳 status_code=500, not implemented，這是協定不相容。請改用該模型標示支援的介面；Claude Code 維持原生 Messages 設定。重送相同請求不會修正協定不相容的問題。

​
為什麼位址看起來可能不同

通用 OpenAI 風格請求通常使用：
有些用戶端要求填寫不含 /v1 的站點位址，或會自行補上 /chat/completions、/responses、/messages 等路徑。請以相應工具教學為準；圖片模型則依照圖片模型使用說明呼叫。
避免重複路徑如果用戶端本身會補上 /v1，手動填入後可能形成 /v1/v1/... 並造成 404。遇到 404 時，先檢查用戶端實際送出的請求位址。

​
不要混用用戶端設定與通用 API

CLI 工具、編輯器外掛與自建程式可能使用不同協定和設定檔。即使模型名稱相同，也不要把某個工具的整段設定直接套用到另一個工具。
  • **設定 Codex CLI：**請閱讀 Codex 教學，使用 Responses 相關設定。
  • **設定 Claude Code：**請閱讀 Claude Code 教學，使用 Anthropic Messages 相關設定。
  • **自行開發文字程式：**除非 SDK 明確要求其他協定，否則先從 Chat Completions 開始。
  • **呼叫圖片：**使用圖片端點，不要把圖片生成參數傳給文字聊天端點。
  • **不確定時：**先確認用戶端名稱，並檢查其實際送出的請求路徑。

​
API 參考文件

先閱讀介面與模型能力矩陣，確認目標模型應使用的協定；Chat Completions 的最小請求見Chat Completions 介面。 本說明中心負責解釋「如何選擇與設定」，並提供可直接驗證的最小請求。選用欄位仍須依使用的用戶端協定及模型廣場目前顯示的能力決定。

​
如何確認設定成功

  • 用戶端可正常取得完整回應。
  • 控制台使用紀錄出現對應請求。
  • 紀錄中的模型、群組與扣費符合預期。
若呼叫失敗，請保留錯誤原文與 Request ID，接著進入問題自查。