Документация NeuroAPI
Введение

Как получить API-ключ

Пошагово: регистрация, создание ключа в кабинете, выбор тарифа, хранение и первый запрос.

API-ключ NeuroAPI — это секрет, которым приложение подтверждает право расходовать баланс аккаунта. Ключ создаётся в личном кабинете, а не выдаётся автоматически, поэтому сначала нужен аккаунт.

Важно: ключ NeuroAPI — это ключ сервиса NeuroAPI, а не официальный ключ OpenAI, Anthropic или Google. Он работает только с адресом https://neuroapi.host/v1 и нативными эндпоинтами NeuroAPI.

Шаг 1. Создайте аккаунт

Откройте страницу входа и зарегистрируйтесь по email или через поддерживаемый OAuth-провайдер. Для корпоративного сценария можно сразу зарегистрировать компанию по ИНН — тогда доступны корпоративный баланс, роли и документы.

После регистрации вы попадёте в личный кабинет. Для работы с API не нужен VPN: запросы идут на https://neuroapi.host/v1.

Шаг 2. Создайте ключ

  1. Откройте раздел «Токены» в кабинете: /dashboard/tokens.
  2. Нажмите «Создать ключ» и дайте ему понятное имя, например backend-prod или cursor-local.
  3. Выберите тариф: Пилот, Смарт или Оптимальный.
  4. Скопируйте ключ сразу после создания и сохраните в менеджере секретов.

Тариф выбирается на этапе создания ключа. Для разных задач удобно держать разные ключи: разработка на Пилоте, production — на Смарте или Оптимальном. Так проще контролировать расходы и отзывать доступ точечно.

Шаг 3. Сохраните ключ безопасно

  • Не коммитьте ключ в Git и не вставляйте его в публичные конфиги.
  • Храните секреты в переменных окружения или менеджере секретов.
  • Не переиспользуйте один ключ во всех сервисах: отдельный ключ на интеграцию упрощает аудит.
  • При компрометации отзовите ключ в кабинете и создайте новый.

Шаг 4. Сделайте первый запрос

Передавайте ключ в заголовке Authorization: Bearer <NEUROAPI_API_KEY>. Базовый URL — https://neuroapi.host/v1.

curl https://neuroapi.host/v1/chat/completions \
  -H "Authorization: Bearer $NEUROAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-mini",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://neuroapi.host/v1",
    api_key="<NEUROAPI_API_KEY>",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(response.choices[0].message.content)

Проверить, какие модели доступны ключу, можно через GET /v1/models. Точные имена моделей и цены — в каталоге.

Типовые проблемы

СимптомВероятная причинаЧто делать
401 UnauthorizedКлюч неверен, отозван или передан без BearerПроверьте ключ и заголовок Authorization
404 по моделиОпечатка в Model ID или модель недоступна на тарифеСверьте имя с карточкой модели в каталоге
429 Too Many RequestsПревышены лимитыПроверьте лимиты и повторите позже
Неизвестный адресВ клиенте остался старый base_urlУкажите https://neuroapi.host/v1

Подробный разбор кодов — в разделе Ошибки. Если подключение уже работало и перестало, проверьте инструкцию по восстановлению.

Дальше

On this page