> ## 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: аутентификация, модели и протоколы

> Проверьте Base URL, API key, ID модели и протокол перед вызовом NexusAPI.

Здесь описаны правила, общие для всех вызовов моделей. Полные схемы запросов и ответов находятся в [справочнике API Apifox](https://nexusapi.apifox.cn/); эта документация объясняет, **какой протокол выбрать и как безопасно начать**.

<Info>
  **Сначала подтвердите возможности**

  Доступные модели зависят от группы API key, ограничений модели и текущего состояния сервиса. Общий каталог не гарантирует, что конкретная модель доступна для вашей ключа.
</Info>

## Три обязательных значения

| Значение  | Где получить                     | Назначение                                    |
| --------- | -------------------------------- | --------------------------------------------- |
| Base URL  | Эта страница                     | Направляет запросы SDK или клиента в NexusAPI |
| API key   | Console → Token management       | Идентифицирует вызывающего и доступные группы |
| ID модели | Каталог моделей или `/v1/models` | Выбирает модель для запроса                   |

Для стандартного клиента в стиле OpenAI используйте:

```text theme={"system"}
https://nexusapi.link/v1
```

В ручном HTTP-запросе передавайте ключ через `Authorization`:

```http theme={"system"}
Authorization: Bearer YOUR_API_KEY
```

Не помещайте полный key в frontend, скриншоты, чат или Git-репозиторий. Правила URL у клиентов различаются: Claude Code использует адрес без `/v1`, Codex CLI — настройку Provider. Следуйте соответствующему [руководству по клиентским инструментам](/ru/tools/index).

## Получить модели, видимые этому key

```bash theme={"system"}
curl 'https://nexusapi.link/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

Скопируйте ID из `data[].id`. Это модели, **видимые сейчас данному key**, а не весь каталог. Если в ответе есть `supported_endpoint_types`, поле помогает определить указанный тип протокола.

## Выбрать правильный протокол

| Цель                                  | Путь                          | Когда использовать                                                                 |
| ------------------------------------- | ----------------------------- | ---------------------------------------------------------------------------------- |
| Текст, чат и streaming в стиле OpenAI | `POST /v1/chat/completions`   | Большинство собственных приложений, OpenAI SDK и обычных клиентов                  |
| Нативный Anthropic / Claude Code      | `POST /v1/messages`           | Модели с меткой `anthropic`                                                        |
| Provider Codex                        | `POST /v1/responses`          | Только по [руководству Codex CLI](/ru/tools/codex-cli) и для подтверждённой модели |
| Генерация изображений                 | `POST /v1/images/generations` | Модель изображений, доступная текущей группе                                       |

Одинаковое имя модели не означает поддержку любого формата запроса. Подтвердите протокол в [матрице возможностей](/ru/developer/capability-matrix), затем прочитайте:

* [Chat Completions](/ru/developer/openai-compatible)
* [Anthropic Messages](/ru/developer/anthropic-messages)
* [Responses / Codex](/ru/developer/responses)
* [Работа с моделями изображений](/ru/guide/image-generation)

## Минимальная проверка и повторы

1. Получите список моделей, затем отправьте один короткий текстовый или минимальный image-запрос.
2. Подтвердите ID модели, группу key и путь до добавления полей, streaming или пакетных задач.
3. При ошибке сохраните текст ошибки, время и Request ID. Не повторяйте неподтверждённый запрос с высокой частотой.

Для `401` сначала проверьте key. Для `404` — отсутствие или повтор `/v1`. Для `400` — модель, протокол и поля. Подробнее — в [самопроверке](/ru/faq/self-check).