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

# API Chat Completions

> Вызывайте текстовые модели NexusAPI в формате OpenAI Chat Completions.

Эта страница описывает только **OpenAI Chat Completions**. Перед вызовом проверьте модель, группу токена и протокол в [матрице возможностей](/ru/developer/capability-matrix).

<Tip>
  Каталог моделей и матрица показывают текущую доступность. Подробные поля и схемы ответов приведены в [справочнике API Apifox](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": "Здравствуйте"}]
  }'
```

| Заголовок       | Нужен | Значение              |
| --------------- | ----- | --------------------- |
| `Content-Type`  | Да    | `application/json`    |
| `Authorization` | Да    | `Bearer YOUR_API_KEY` |

## Минимальные поля и streaming

| Поле       | Нужен | Назначение                                                                            |
| ---------- | ----- | ------------------------------------------------------------------------------------- |
| `model`    | Да    | Точный ID, видимый текущему key и отмеченный `openai`                                 |
| `messages` | Да    | Сообщения диалога в формате Chat Completions                                          |
| `stream`   | Нет   | Используйте `true` для streaming-событий, только если модель и клиент поддерживают их |

В обычном ответе текст обычно читается из `choices[0].message.content`; в потоковом — из каждого `choices[0].delta.content`. Сначала проверьте модель и key минимальным запросом без streaming, затем включайте `stream` или добавляйте поля.

`temperature`, tool calls, визуальный ввод и структурированный вывод не гарантированы для всех моделей только из-за «OpenAI-совместимости». Schema полей смотрите в [справочнике API Apifox](https://nexusapi.apifox.cn/), а доступность модели и канала — в [матрице возможностей](/ru/developer/capability-matrix) и каталоге.

## Первые проверки при ошибке

| Результат       | Что проверить                                                            |
| --------------- | ------------------------------------------------------------------------ |
| 401             | Ключ отсутствует, неверен, истёк или отключён.                           |
| 429             | Частоту, параллельность или временное ограничение upstream.              |
| 500 / 502 / 503 | Временную ошибку обработки или upstream; подождите и повторите один раз. |
| 524             | Превышен лимит ожидания.                                                 |

`status_code=500, not implemented` при вызове Anthropic-типа Claude через `/v1/responses` означает несовместимость протокола, а не обычную ошибку 500. Для своего приложения используйте Chat Completions, для Claude Code — нативную настройку Messages. Сохраните Request ID и пройдите [самопроверку](/ru/faq/self-check).

## Связанные API

* Модели, видимые текущему key, и выбор протокола: [основы API](/ru/developer/api-basics)
* Нативный клиент Claude / Anthropic: [Anthropic Messages](/ru/developer/anthropic-messages)
* Provider Codex: [API Responses и Codex](/ru/developer/responses)
* Генерация изображений: [Работа с моделями изображений](/ru/guide/image-generation)