Chat Completions 介面 - NexusAPI

本頁只說明 OpenAI Chat Completions。在呼叫前，請先閱讀介面與模型能力矩陣，確認模型、令牌群組與協定相符。

模型廣場和能力矩陣用於確認目前的模型、群組與協定。

端點

POST https://nexusapi.link/v1/chat/completions

最小請求

curl 'https://nexusapi.link/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Header	是否必要	值
`Content-Type`	是	`application/json`
`Authorization`	是	`Bearer YOUR_API_KEY`

最小欄位與串流輸出

欄位	是否需要	用途
`model`	是	使用目前 Key 可見，且 `supported_endpoint_types` 包含 `openai` 的正確模型 ID
`messages`	是	以 Chat Completions 格式傳遞對話訊息
`stream`	否	設為 `true` 時以串流事件消費；僅在模型與用戶端都支援時使用

一般回應通常從 choices[0].message.content 讀取文字；串流回應則逐段讀取 choices[0].delta.content。先用非串流最小請求驗證模型與 Key，再開啟 stream 或加入選填欄位。 temperature、工具呼叫、視覺輸入、結構化輸出等選填欄位，不會因為「OpenAI 相容」而自動適用所有模型；模型目前支援的能力以介面與模型能力矩陣及模型廣場為準。

常見結果

結果	先檢查什麼
401	Key 是否缺失、無效、到期或停用。
429	請求頻率、併發或暫時性上游限流。
500／502／503	暫時處理或上游錯誤；低頻等待後只重試一次。
524	請求超過等待上限。

若出現 status_code=500, not implemented，請勿將它視為一般 500 而高頻重試；這通常表示模型與請求協定不相容。先確認該模型的 supported_endpoint_types 是否包含 openai，再選擇相符的介面。其他錯誤請保留 Request ID，依問題自查處理，避免快速重試。

相關介面

先列出目前 Key 可見模型並選協定：API 基礎
原生 Claude / Anthropic 用戶端：Anthropic Messages
Codex Provider：Responses 介面與 Codex
圖片生成：圖片模型使用說明