> ## 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 API

> OpenAI Chat Completions 形式で NexusAPI のテキストモデルを呼び出します。

このページは **OpenAI Chat Completions** のみを扱います。呼び出す前に、[API とモデル対応マトリクス](/ja/developer/capability-matrix)でモデル、トークングループ、プロトコルが合うことを確認してください。

<Tip>
  現在のモデル可用性はモデルマーケットプレイスと対応マトリクスで確認します。詳細なフィールドやレスポンス形式は [Apifox API リファレンス](https://nexusapi.apifox.cn/)を参照してください。
</Tip>

## Endpoint

```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": "こんにちは"}]
  }'
```

| 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` からテキストを読みます。`stream` やオプションを追加する前に、非ストリーミングの最小リクエストでモデルと Key を確認してください。

`temperature`、ツール呼び出し、画像入力、構造化出力などのオプションは、「OpenAI 互換」だけで全モデルに保証されるものではありません。フィールド Schema は [Apifox API リファレンス](https://nexusapi.apifox.cn/)で、モデル/チャネルの可用性は[API とモデル対応マトリクス](/ja/developer/capability-matrix)とモデルマーケットプレイスで確認してください。

## よくある結果

| 結果              | 最初の確認                      |
| --------------- | -------------------------- |
| 401             | Key の欠落、無効、期限切れ、無効化。       |
| 429             | リクエスト頻度、同時実行数、上流の一時制限。     |
| 500 / 502 / 503 | 一時的な処理または上流障害。待機して一度だけ再試行。 |
| 524             | 待機時間の上限超過。                 |

Anthropic 型 Claude チャネルを `/v1/responses` で呼び出して `status_code=500, not implemented` が出た場合は、通常の 500 ではなくプロトコル不一致です。自作アプリでは Chat Completions、Claude Code ではネイティブ Messages 設定を使用してください。Request ID を保存して[自己確認](/ja/faq/self-check)を行います。

## 関連 API

* 現在の Key に見えるモデルとプロトコル選択：[API 基本](/ja/developer/api-basics)
* ネイティブ Claude / Anthropic クライアント：[Anthropic Messages](/ja/developer/anthropic-messages)
* Codex Provider：[Responses API と Codex](/ja/developer/responses)
* 画像生成：[画像モデルの利用方法](/ja/guide/image-generation)