Base URL и эндпоинты

NeuroAPI — единый шлюз к моделям разных провайдеров. Для всех клиентских форматов используется один базовый адрес: если вы уже работали с OpenAI-совместимым клиентом, менять нужно только Base URL и API-ключ, а путь запроса клиент добавляет сам.

Эта страница — короткий справочник по адресам. Для первого запроса откройте быстрый старт, для выбора протокола — форматы API.

Запомните: Base URL — это https://neuroapi.host/v1. Не добавляйте к нему путь /chat/completions вручную в настройках SDK: клиент сам допишет /chat/completions, /responses или /images/generations.

Канонический Base URL

https://neuroapi.host/v1

Этот адрес подставляется в поле «Base URL», «API Base», «OpenAI API URL» или base_url — названия в разных клиентах отличаются, значение одно и то же. Один Base URL работает для всех форматов: OpenAI Chat Completions, Responses, Anthropic Messages и Gemini; меняется только путь конкретного метода.

В настройках клиента не нужно указывать адрес кабинета, страницу модели или полный URL конкретного метода. Достаточно базового адреса: SDK сам формирует итоговый запрос. Например, для Chat Completions клиент выполняет POST https://neuroapi.host/v1/chat/completions.

Если клиент просит «полный endpoint», а не Base URL, используйте Base URL плюс путь из таблицы ниже, но не дублируйте /v1 дважды.

Авторизация

Ключ передаётся в заголовке:

Authorization: Bearer <NEUROAPI_API_KEY>

API-ключ выпускается в личном кабинете, в разделе «Токены». Как создать ключ и выбрать тариф — в гайде по API-ключу.

Ключ NeuroAPI — самостоятельный ключ сервиса NeuroAPI. Он не является официальным ключом OpenAI, Anthropic или Google, хотя и используется в OpenAI-совместимых SDK. Храните ключ как секрет: не коммитьте его в репозиторий и не вставляйте в публичные примеры.

Эндпоинты

Пути в таблице указаны от корня сайта, а не от Base URL: в коде запроса они добавляются к https://neuroapi.host/v1 автоматически.

Как формируется адрес запроса

Base URL — это только префикс. Итоговый адрес получается сложением базового адреса и пути метода. Например, при вызове client.chat.completions.create() OpenAI SDK отправляет запрос на https://neuroapi.host/v1/chat/completions, а при client.responses.create() — на https://neuroapi.host/v1/responses. Поэтому в поле «Base URL» не нужно вписывать путь метода: иначе адрес может получиться склеенным дважды.

Некоторые клиенты хранят не Base URL, а полный адрес провайдера. В таком случае используйте полный путь из таблицы: https://neuroapi.host/v1/responses, https://neuroapi.host/v1/images/generations и так далее. Главное правило одно: /v1 встречается в адресе ровно один раз, а хост — только neuroapi.host.

Стабильные и Beta-форматы

Стабильный контракт — OpenAI-совместимый: Chat Completions, Responses, изображения и видео. Anthropic Messages и Gemini GenerateContent доступны как Beta: формат уже работает, но может получать уточнения полей, валидаций и потоковых событий. Метка Beta относится к формату API, а не к качеству модели. Подробнее — в форматах API.

Отдельно учитывайте, что GET /v1/models показывает модели, доступные конкретному ключу, но не гарантирует, что каждая из них поддерживает все форматы и функции. Совместимость определяется парой «модель + формат»: перед интеграцией сверьтесь с гайдом задачи и карточкой модели.

Как проверить Base URL

Самый быстрый способ убедиться, что адрес и ключ заданы верно, — запросить список моделей:

curl https://neuroapi.host/v1/models \
  -H "Authorization: Bearer $NEUROAPI_API_KEY"

Ответ 200 со списком моделей означает, что Base URL и авторизация настроены корректно. Если запрос возвращает 401, проверьте ключ и заголовок Authorization; если 404 — сверьте адрес (частая причина: пропущен /v1 или указан другой хост).

Ответ содержит массив data с идентификаторами моделей. Этот список зависит от тарифа ключа и от текущей публикации каталога: если ответ 200, но список пуст, проверьте, что ключ активен и что на его тарифе опубликованы модели. Менять из-за этого Base URL не нужно.

Проверка из SDK выглядит так же: client.models.list() использует тот же адрес из конфигурации клиента. Если SDK возвращает ошибку авторизации, а cURL с тем же ключом работает, ищите проблему в переменных окружения клиента или в том, что ключ передаётся другому приложению.

Base URL в SDK и переменных окружения

Большинство SDK читают адрес и ключ из переменных окружения. Для Python и Node.js это стандартные имена OpenAI SDK:

export OPENAI_API_KEY="<NEUROAPI_API_KEY>"
export OPENAI_BASE_URL="https://neuroapi.host/v1"

from openai import OpenAI

# OPENAI_API_KEY и OPENAI_BASE_URL берутся из окружения
client = OpenAI()

import OpenAI from 'openai';

// OPENAI_API_KEY и OPENAI_BASE_URL берутся из окружения
const openai = new OpenAI();

Если приложение использует собственные имена переменных или файл конфигурации, обновите их так же: замените адрес и ключ, не меняя структуру кода. Часть SDK версий читает переменные по-разному — если сомневаетесь, передайте base_url / baseURL явно, как в быстром старте.

Нативные клиенты

Клиенты, которые не поддерживают OpenAI-совместимый протокол, могут обращаться к нативным Beta-маршрутам: Anthropic-клиенты — к POST /v1/messages, Gemini-клиенты — к POST /v1beta/models/{model}:generateContent. Адрес хоста при этом тот же, https://neuroapi.host/v1 (для Gemini путь начинается с /v1beta). Подробности выбора — в форматах API.

Готовые конфигурации для редакторов кода, чатов и автоматизации собраны в разделе «Интеграции»: для большинства клиентов там указаны те же три поля — base URL, ключ и Model ID.

Частые ошибки при настройке адреса

• 401 — ключ не передан, отозван или скопирован с лишними символами. Проверьте заголовок Authorization: Bearer ….
• 404 — неверный путь: пропущен /v1, указан адрес кабинета вместо API или использован метод, которого нет у выбранной модели.
• 429 — сработали лимиты. Причины и правила повторов описаны в документации по лимитам и в справочнике ошибок.
• Таймауты на streaming — проверьте настройки клиента и гайд Streaming. Возможности зависят от модели.

Если клиент долго не подключается, хотя адрес верный, откройте восстановление подключения: инструкция помогает найти старый адрес или конфликт конфигурации.

Отдельно проверьте, не переопределяет ли адрес ваш фреймворк: часть библиотек читает переменную OPENAI_BASE_URL и использует её вместо значения, переданного в коде. Если запросы продолжают уходить на прежний адрес, ищите переменную окружения, профиль клиента или сохранённую конфигурацию, а не только настройку SDK.

Куда дальше

• Быстрый старт — первый запрос через SDK или cURL.
• Как получить API-ключ — регистрация, тариф и сохранение ключа.
• Форматы API — OpenAI, Anthropic и Gemini: что выбрать.
• Каталог моделей — как устроен список моделей и Model ID.
• Модели и цены — актуальный каталог и ставки в рублях.
• Ошибки и статусы — коды, причины и повторные попытки.