# Обзор

Один OpenAI-совместимый API для сотен моделей в глобальном регионе и в России, оплата в PnP с баланса Nodul.

Nodul Router дает один адрес и один API-ключ для всех моделей [каталога](/models). Запросы и ответы — в формате OpenAI Chat Completions, поэтому SDK OpenAI и большинство инструментов, где можно указать свой base URL, работают без изменений.

## Base URL

```text
https://router.nodul.ru/api/v1
```

Каждый запрос передает API-ключ пространства Router в заголовке `Authorization: Bearer`. Подробнее — в разделе [Аутентификация](/docs/ru/authentication).

## Регионы

Каждая модель работает в одном регионе:

| Регион     | ID моделей                                      | Что это значит                                         |
| ---------- | ----------------------------------------------- | ------------------------------------------------------ |
| Глобальный | `vendor/model`, например `google/gemma-3-4b-it` | Запрос может обработать провайдер за пределами России. |
| Россия     | `ru-1/…`, `ru-2/…`                              | Модель размещена в России, запрос не покидает страну.  |

`GET /api/v1/models` возвращает модели с регионом (`routes[].provider` — `global` или `ru`). Как выбирать и сочетать модели — в разделе [Модели и маршрутизация](/docs/ru/models-and-routing).

## Оплата

Запросы оплачиваются в PnP, валюте платформы Nodul, с баланса плательщика пространства Router. Поле `usage.cost` в ответе — точная сумма списания за этот запрос. Подробнее — в разделе [Цены и оплата](/docs/ru/pricing-and-billing).

## Приватность

Роутер не хранит промпты и ответы, если владелец пространства Router не включил журнал содержимого. У провайдеров свои правила хранения данных: чтобы отправить запрос только провайдерам, которые ничего не хранят, добавьте `"provider": {"zdr": true}`. Подробнее — в разделе [Без хранения данных (ZDR)](/docs/ru/zero-data-retention).

## Что дальше

- [Быстрый старт](/docs/ru/quickstart): первый запрос за минуту.
- [Параметры](/docs/ru/parameters): все поля запроса — что роутер проверяет, а что передает как есть.
- [Ошибки](/docs/ru/errors): коды ответов и что делать с каждым.