# Claude Sonnet 5.5 — /chat/completions

OpenAI 兼容的对话补全接口，承载 Anthropic Claude Sonnet 5.5：Sonnet 系列最新型号，速度与智能的最佳组合，100 万 token 上下文、单次最多输出 128K token，思考自适应。支持图片理解、工具调用、提示缓存、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 接口 /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} 组成的数组以识别图片（多模态/Vision）。 |
| `stream` | boolean | 否 | 是否以 SSE 流式返回。默认 false。 |
| `temperature` | number | 否 | 不生效：该模型忽略 temperature / top_p（不报错），按模型默认采样。 |
| `max_tokens` | integer | 否 | 最大生成 token 数。 |
| `web_search` | boolean | 否 | 设为 true 开启联网搜索：网关会先用实时搜索补充资料、再让模型作答并附来源链接（也可在 tools 里传 {"type":"web_search"} 触发）。 |
| `reasoning_effort` | string | 否 | OpenAI 兼容接口上不生效：模型按默认强度思考。要调节思考强度，请走原生 Anthropic 接口，在请求里传 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}
}
```

## 图片识别（Vision）
在 messages 的 content 数组里传入图片，即可让模型识别图片内容（看图问答、读图中文字/OCR 等）。image_url 支持公网图片链接，或 base64 内联（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"}}]}]}'
```