# Claude Sonnet 5.5 — /chat/completions

Anthropic Claude Sonnet 5.5 による OpenAI 互換のチャット補完 API です。Sonnet シリーズの最新モデルで、速度と知能の最良の組み合わせ。100 万トークンのコンテキスト、1 回あたり最大 128K トークンの出力、適応的な思考を備えます。画像入力、ツール呼び出し、プロンプトキャッシュ、stop、ストリーミングに対応し、model を claude-sonnet-5-5 にするだけで使えます。OpenAI 互換のエンドポイントでは既定の強度で考え、思考の内容は返さず、response_format が効くとは限りません。思考強度（output_config.effort：low / medium / high / xhigh / max）、思考の要約（thinking.display: summarized）、構造化出力（output_config.format）、PDF 入力を使うには、ネイティブの Anthropic Messages API /anthropic/v1/messages を使ってください。Claude Code から直接つなげます。temperature / top_p / top_k は無視され、ツールの強制呼び出しは auto として扱い、thinking を disabled にしても無視されます。

**エンドポイント:** `POST https://nezhagate.com/v1/chat/completions`

## 認証
```
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## リクエストボディ
| パラメータ | 種別 | 必須 | 説明 |
| --- | --- | --- | --- |
| `model` | string | はい | モデル ID。ここでは claude-sonnet-5-5 です。 |
| `messages` | array | はい | メッセージの配列。各要素は role（system/user/assistant）と content を持ちます。content は文字列のほか、画像を理解させる場合は {type:text} と {type:image_url} を並べた配列にできます（マルチモーダル / ビジョン）。 |
| `stream` | boolean | いいえ | SSE でストリーミング出力します。既定は false です。 |
| `temperature` | number | いいえ | 効果なし：このモデルは temperature / top_p を無視し（エラーにはなりません）、既定のサンプリングで動作します。 |
| `max_tokens` | integer | いいえ | 生成するトークン数の上限。 |
| `web_search` | boolean | いいえ | true にするとウェブ検索を有効にします。モデルが答える前に、ゲートウェイがリアルタイムの検索結果でプロンプトを補強し、出典も添えます。tools に {"type":"web_search"} を入れても同じように動きます。 |
| `reasoning_effort` | string | いいえ | OpenAI 互換のエンドポイントでは効きません。モデルは既定の強度で考えます。思考強度を指定するには、ネイティブの Anthropic API で output_config.effort（low / medium / high / xhigh / max）を送ってください。 |

## リクエスト例
```bash
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": "Hello"}], "stream": false}'
```

## レスポンス
```json
{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "model": "claude-sonnet-5-5",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 11, "completion_tokens": 7, "total_tokens": 18}
}
```

## 画像入力（ビジョン）
メッセージの content 配列に画像を入れると、モデルがそれを解析します（画像についての質問、文字の読み取り / OCR など）。image_url には公開画像のリンクか、インラインの base64 データ URL（data:image/png;base64,...）を指定できます。マルチモーダル対応モデル（gpt-5.5、gemini シリーズなど）で利用できます。

```bash
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": [{"type": "text", "text": "What is in this image?"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}]}]}'
```