Перейти к содержанию

Настройка клиентов

Один Nexus API-ключ подходит любому клиенту. Создайте его в Telegram-боте и добавьте в клиенте отдельную запись подключения, чтобы штатное подключение клиента осталось на месте. Эта запись не является вторым аккаунтом Nexus и не создаёт второй баланс.

Базовый URL зависит от протокола, на котором говорит клиент. Указывайте базу, а не полный маршрут: клиент сам дописывает путь операции.

Сценарий Протокол Базовый URL Маршрут, который строит клиент
Чат-приложения и большинство OpenAI-совместимых инструментов OpenAI Chat https://api.nexus-hub.tech/v1 POST /v1/chat/completions
Codex и response-клиенты OpenAI Responses https://api.nexus-hub.tech/v1 POST /v1/responses
Claude Code и Claude Desktop Anthropic Messages https://api.nexus-hub.tech POST /v1/messages
Gemini-клиенты Gemini-compatible https://api.nexus-hub.tech/v1beta POST /v1beta/models/{model}:generateContent

Порядок настройки

  1. Создайте Nexus API-ключ в Telegram-боте.
  2. Добавьте в клиенте отдельную запись подключения.
  3. Выберите протокол и базовый URL из таблицы.
  4. Вставьте ключ в защищённое поле клиента или в переменную окружения. Не добавляйте префикс Bearer, если поле не просит заголовок целиком.
  5. Скопируйте id модели из GET /v1/models для этого ключа. На странице Модели и цены проверьте, к какому семейству маршрутов относится этот id.
  6. Отправьте короткое сообщение. Обычный ответ означает, что подключение работает.

Выберите протокол

Подходит чат-приложениям, включая Cherry Studio. Базовый URL https://api.nexus-hub.tech/v1. Клиент вызывает POST /v1/chat/completions.

Подходит Codex. Базовый URL https://api.nexus-hub.tech/v1. Клиент вызывает POST /v1/responses. Не переключайте Codex на Chat Completions.

Подходит Claude Code и Claude Desktop. Базовый URL https://api.nexus-hub.tech, без суффикса /v1. Клиент вызывает POST /v1/messages и передаёт anthropic-version: 2023-06-01.

Используйте https://api.nexus-hub.tech/v1beta только там, где клиент описывает формат Gemini. Id модели стоит в пути запроса.

Перед диагностикой

Ещё раз проверьте маршрут, id модели для этого ключа и точное поле в клиенте. В поддержку передавайте маршрут, код ошибки, примерное время и x-request-id. Не отправляйте ключ, полный prompt или заголовки запроса.

Если не работает

  • 401 или invalid_key: ключа нет, в нём лишние пробелы, либо его отозвали.
  • model_not_found или model_not_allowed: этого id нет в GET /v1/models для ключа.
  • unsupported_model: id виден, но не на этом протоколе. Выберите другой маршрут или другой id.
  • endpoint_not_allowed: этому ключу не разрешён выбранный маршрут.
  • 404 или unsupported_endpoint: сравните адрес, который реально вызывает клиент, с таблицей. Не вставляйте полный путь операции в поле базы.

Nexus также принимает путь без /v1, повторный /v1 и хвостовой слэш. Всё равно указывайте чистую базу из таблицы и сверяйтесь с предпросмотром адреса, если клиент его показывает.

Таблица значений — в матрице совместимости. Инструкции: Codex CLI, ChatGPT / Codex Desktop, Claude Code, Claude Desktop, VS Code, Zed, T3 Code, CC Switch, Cherry Studio, прямой API, собственная интеграция и другой клиент.