# Claude Opus 5 — /chat/completions

Совместимые с OpenAI chat completions на базе Anthropic Claude Opus 5 — адаптивное рассуждение по умолчанию, с поддержкой ввода изображений, вызова инструментов, кэширования промптов и потокового вывода. Укажите в поле model значение claude-opus-5. Примечание: у этой модели провайдер прекратил поддержку temperature / top_p / top_k; шлюз молча отбрасывает их (без ошибки), и сэмплирование выполняется со значениями по умолчанию для модели. Вместо этого используйте reasoning_effort (low / medium / high / xhigh / max) для управления глубиной рассуждения.

**Эндпоинт:** `POST https://nezhagate.com/v1/chat/completions`

## Аутентификация
```
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Тело запроса
| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `model` | string | Да | Model ID, here claude-opus-5. |
| `messages` | array | Да | Массив сообщений; у каждого есть role (system/user/assistant) и content. content может быть строкой или массивом частей {type:text} и {type:image_url} для распознавания изображений (мультимодальность/зрение). |
| `stream` | boolean | Нет | Возвращать ответ потоково через SSE. По умолчанию false. |
| `temperature` | number | Нет | Не поддерживается. Эта модель отказалась от параметров сэмплирования; шлюз молча отбрасывает temperature / top_p / top_k (без ошибки), и сэмплирование выполняется со значениями по умолчанию для модели. Вместо этого используйте reasoning_effort, чтобы разменивать глубину рассуждений на скорость. |
| `max_tokens` | integer | Нет | Максимальное количество генерируемых токенов. |
| `web_search` | boolean | Нет | Установите true, чтобы включить веб-поиск: шлюз дополняет промпт актуальными результатами (со ссылками на источники) перед тем, как модель формирует ответ. Также можно включить через элемент tools вида {"type":"web_search"}. |
| `reasoning_effort` | string | Нет | Уровень усилий на рассуждение: low / medium / high / xhigh / max. Чем выше уровень, тем глубже, медленнее и дороже — токены рассуждения оплачиваются по тарифу вывода и учитываются в usage.completion_tokens. Не указывайте параметр — модель решит адаптивно сама. Шлюз преобразует это значение в нативный output_config.effort модели; на нативном эндпоинте Anthropic вы можете передавать output_config самостоятельно. Суффиксная форма тоже работает (например, claude-opus-5-high) и оплачивается точно так же, как базовая модель. |

## Пример запроса
```bash
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "claude-opus-5", "messages": [{"role": "user", "content": "Hello"}], "stream": false}'
```

## Ответ
```json
{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "model": "claude-opus-5",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 11, "completion_tokens": 7, "total_tokens": 18}
}
```

## Ввод изображений (Vision)
Поместите изображение в массив content сообщения, и модель проанализирует его (визуальные вопрос-ответ, распознавание текста / OCR, …). Поле image_url принимает публичную ссылку на изображение или встроенный base64 data 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-opus-5", "messages": [{"role": "user", "content": [{"type": "text", "text": "What is in this image?"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}]}]}'
```