> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat Completions 介面

> 使用 OpenAI Chat Completions 格式呼叫 NexusAPI 的文字模型。

本頁只說明 **OpenAI Chat Completions**。在呼叫前，請先閱讀[介面與模型能力矩陣](/zh-TW/developer/capability-matrix)，確認模型、令牌群組與協定相符。

<Tip>
  模型可用性與欄位定義來源不同：模型廣場和能力矩陣用於確認目前的模型、群組與協定；[Apifox API 文件](https://nexusapi.apifox.cn/)用於查詢完整欄位與回應結構。
</Tip>

## 端點

```text theme={"system"}
POST https://nexusapi.link/v1/chat/completions
```

## 最小請求

```bash theme={"system"}
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 可見且標示為 `openai` 的正確模型 ID |
| `messages` | 是    | 以 Chat Completions 格式傳遞對話訊息       |
| `stream`   | 否    | 設為 `true` 時以串流事件消費；僅在模型與用戶端都支援時使用 |

一般回應通常從 `choices[0].message.content` 讀取文字；串流回應則逐段讀取 `choices[0].delta.content`。先用非串流最小請求驗證模型與 Key，再開啟 `stream` 或加入選填欄位。

`temperature`、工具呼叫、視覺輸入、結構化輸出等選填欄位，不會因為「OpenAI 相容」而自動適用所有模型。欄位 Schema 請看 [Apifox API 文件](https://nexusapi.apifox.cn/)；模型與渠道能力以[介面與模型能力矩陣](/zh-TW/developer/capability-matrix)及模型廣場為準。

## 常見結果

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

若以 `/v1/responses` 呼叫當前 Anthropic 類 Claude 渠道出現 `status_code=500, not implemented`，這是協定不相容，不是一般 500。自建程式請改用本頁的 Chat Completions；Claude Code 請使用原生 Messages 設定。

其他錯誤請保留 Request ID，依[問題自查](/zh-TW/faq/self-check)處理，避免快速重試。

## 相關介面

* 先列出目前 Key 可見模型並選協定：[API 基礎](/zh-TW/developer/api-basics)
* 原生 Claude / Anthropic 用戶端：[Anthropic Messages](/zh-TW/developer/anthropic-messages)
* Codex Provider：[Responses 介面與 Codex](/zh-TW/developer/responses)
* 圖片生成：[圖片模型使用說明](/zh-TW/guide/image-generation)