Skip to main content
NexusAPI поддерживает популярные AI-клиенты и API в стиле OpenAI. Разные инструменты могут автоматически добавлять части пути запроса, поэтому указывайте адрес для конкретного способа использования и не переносите всю конфигурацию одного инструмента в другой.

​
Подготовка

Перед началом любой интеграции убедитесь, что:
  1. В консоли создан API-ключ.
  2. Группа этого API-ключа включает нужную модель.
  3. Точный идентификатор модели скопирован из каталога моделей.
  4. Для модели выбран поддерживаемый тип API, а запросы отправляются по HTTPS.

​
Распространённые сценарии

​
URL и протоколы

Эта таблица помогает выбрать способ интеграции. Сначала проверьте модель и протокол в матрице возможностей API и моделей, а параметры и структуру ответа — в Chat Completions. Фактическая доступность конкретной модели для вашего ключа определяется каталогом моделей.

​
Сначала выберите правильный протокол

Одинаковый Base URL не означает, что каждая модель принимает любой формат запроса.
Не используйте Responses как универсальную альтернативуЕсли supported_endpoint_types модели не содержит openai-response и /v1/responses возвращает status_code=500, not implemented, протокол не совпадает. Используйте endpoint, указанный для модели; в Claude Code сохраните нативную настройку Messages. Повторная отправка того же запроса не устранит несовместимость протокола.

​
Почему URL могут выглядеть по-разному

Для универсального OpenAI-совместимого запроса обычно используется:
Некоторым клиентам нужен URL сайта без /v1; другие сами добавляют /chat/completions, /responses или /messages. Следуйте инструкции для конкретного инструмента. Для изображений используйте руководство по моделям изображений.
Не дублируйте путьЕсли клиент уже добавляет /v1, введённый вручную суффикс может превратить адрес в /v1/v1/... и вызвать 404. При 404 сначала проверьте реальный URL запроса клиента.

​
Не смешивайте настройку клиента и универсальный API

CLI-инструменты, расширения редактора и собственные приложения могут использовать разные протоколы и файлы конфигурации. Даже при одинаковом имени модели нельзя целиком копировать настройку одного инструмента в другой.
  • Codex CLI: используйте руководство Codex CLI и его настройки Responses.
  • Claude Code: используйте руководство Claude Code и нативную конфигурацию Anthropic Messages.
  • Собственное текстовое приложение: начинайте с Chat Completions, если SDK явно не требует другой протокол.
  • Изображения: используйте endpoint изображений, не передавайте параметры генерации изображений в текстовый чат.
  • Если вы не уверены: перед изменением настроек определите точный клиент и путь, который он действительно отправляет.

​
Справочник API

В матрице возможностей API и моделей можно проверить, какой протокол подходит выбранной модели. Минимальный запрос Chat Completions приведён в Chat Completions. Этот справочный центр объясняет, как выбрать и настроить интеграцию, и даёт минимальные проверяемые запросы. Необязательные параметры всегда зависят от протокола клиента и возможностей, отображаемых сейчас в каталоге моделей.

​
Как убедиться, что настройка работает

  • Клиент возвращает полный ответ.
  • Соответствующий запрос появился в журнале использования консоли.
  • Модель, группа и списанная сумма соответствуют ожиданиям.
При ошибке сохраните её текст и Request ID, затем откройте самопроверку.