Обзор

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

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

Base URL

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

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

Регионы

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

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

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

Оплата

Запросы оплачиваются в PnP, валюте платформы Nodul, с баланса плательщика пространства Router. Поле usage.cost в ответе — точная сумма списания за этот запрос. Подробнее — в разделе Цены и оплата.

Приватность

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

Что дальше

Быстрый старт: первый запрос за минуту.
Параметры: все поля запроса — что роутер проверяет, а что передает как есть.
Ошибки: коды ответов и что делать с каждым.