Обзор сервиса¶

Что такое Nexus¶

Nexus — AI API для широкого спектра задач. Он принимает запросы приложений, автоматизаций, чат-ботов и CLI-клиентов, проверяет ключ и возвращает ответ в выбранном совместимом протоколе.

Для пользователя это означает:

не нужно настраивать отдельный зарубежный доступ;
можно использовать привычные CLI-инструменты;
ключ, баланс и список моделей находятся в одном месте;
поддержка и документация доступны на русском языке.

Как работает доступ¶

Каждый API-ключ Nexus настраивается отдельно. У ключа есть:

список доступных маршрутов;
список доступных моделей.

Баланс при этом ведется на уровне профиля Nexus, а несколько ключей одного профиля расходуют общий баланс.

Поэтому два ключа могут видеть разные модели и разные маршруты. Всегда проверяйте актуальный список командой GET /v1/models.

Что поддерживается¶

Nexus поддерживает:

GET /v1/models для проверки доступных моделей;
GET /v1/balance для проверки текущего баланса профиля;
Realtime-совместимые WebSocket-клиенты через GET /v1/realtime;
Claude Code через POST /v1/messages;
подсчет токенов для Claude-совместимых клиентов через POST /v1/messages/count_tokens;
Codex через POST /v1/responses;
compact response-сценарий через POST /v1/responses/compact;
OpenAI-совместимые клиенты через POST /v1/chat/completions;
legacy completions-сценарии через POST /v1/completions.
Gemini-совместимые discovery, generation, token-counting и embedding actions под /v1beta.

Подробный список маршрутов находится на странице Поддерживаемые маршруты

Публичный статус Nexus API, совместимости моделей, документации и Telegram-бота доступен на status.nexus-hub.ru.

Streaming¶

Streaming поддерживается на маршрутах:

POST /v1/chat/completions;
POST /v1/messages;
POST /v1/responses;
POST /v1/responses/compact;
POST /v1beta/models/{model}:streamGenerateContent.

Как считается стоимость¶

Стоимость считается по фактическому использованию модели или по фиксированной цене запроса. Token-based тариф использует ввод, кэшированный ввод, запись кэша и вывод.

Полный usage списывается после ответа, а отсутствующий или противоречивый usage остаётся без списания и без последующего backcharge.

Для GET /v1/realtime действует то же постсписание только по надёжному terminal usage.

Подробнее: Стоимость и баланс