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

Авторизация и базовый URL

Базовый URL

Используйте:

https://api.nexus-hub.ru

Для клиентов, которые ожидают путь /v1 в настройке, указывайте:

https://api.nexus-hub.ru/v1

Как передать ключ

Рекомендуемый вариант:

Authorization: Bearer <YOUR_NEXUS_API_KEY>

Также поддерживаются заголовки:

x-api-key: <YOUR_NEXUS_API_KEY>

api-key: <YOUR_NEXUS_API_KEY>

OpenAI-compatible runtime baseline

Для обычных OpenAI-compatible клиентов используйте:

  • GET /v1/models
  • GET /v1/models/{model}
  • POST /v1/embeddings
  • GET /v1/balance
  • POST /v1/chat/completions
  • POST /v1/completions
  • POST /v1/responses
  • POST /v1/responses/compact

Дополнительно доступны:

  • POST /v1/messages
  • POST /v1/messages/count_tokens
  • GET /v1/realtime
  • POST /v1/images/*
  • POST /v1/audio/*

Быстрая проверка

curl https://api.nexus-hub.ru/v1/models \
  -H "Authorization: Bearer YOUR_NEXUS_API_KEY"

Если ключ активен, ответ содержит модели, доступные именно этому ключу.

Request ID

Nexus возвращает x-request-id в локальных JSON- и SSE-ответах.

Если ваш клиент сам передает x-request-id, Nexus использует его для диагностики. Не отправляйте один и тот же x-request-id повторно для разных запросов: такой повтор может быть отклонен.