Как получить API-ключ
Пошагово: регистрация, создание ключа в кабинете, выбор тарифа, хранение и первый запрос.
API-ключ NeuroAPI — это секрет, которым приложение подтверждает право расходовать баланс аккаунта. Ключ создаётся в личном кабинете, а не выдаётся автоматически, поэтому сначала нужен аккаунт.
Важно: ключ NeuroAPI — это ключ сервиса NeuroAPI, а не официальный ключ OpenAI, Anthropic или Google. Он работает только с адресом
https://neuroapi.host/v1и нативными эндпоинтами NeuroAPI.
Шаг 1. Создайте аккаунт
Откройте страницу входа и зарегистрируйтесь по email или через поддерживаемый OAuth-провайдер. Для корпоративного сценария можно сразу зарегистрировать компанию по ИНН — тогда доступны корпоративный баланс, роли и документы.
После регистрации вы попадёте в личный кабинет. Для работы с API не нужен VPN: запросы идут на https://neuroapi.host/v1.
Шаг 2. Создайте ключ
- Откройте раздел «Токены» в кабинете:
/dashboard/tokens. - Нажмите «Создать ключ» и дайте ему понятное имя, например
backend-prodилиcursor-local. - Выберите тариф: Пилот, Смарт или Оптимальный.
- Скопируйте ключ сразу после создания и сохраните в менеджере секретов.
Тариф выбирается на этапе создания ключа. Для разных задач удобно держать разные ключи: разработка на Пилоте, 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 |
Подробный разбор кодов — в разделе Ошибки. Если подключение уже работало и перестало, проверьте инструкцию по восстановлению.
Дальше
- Форматы API — OpenAI, Anthropic и Gemini: что выбрать.
- Быстрый старт — первый запрос и SDK.
- Интеграции — Cursor, Cline, Roo Code, Open WebUI и другие клиенты.
- Тарифы — как выбрать режим доступа.