Интеграции NeuroAPI: IDE, чаты и автоматизация

Интеграции отличаются не API, а сценарием: редактор кода, настольный чат, веб-интерфейс для команды или автоматизация. Поэтому выбор начинается с задачи, а не с названия инструмента.

Для агентной работы с кодом подойдут Cursor, Claude Code, Codex, Cline и Roo Code. Для общего чата с моделями — Open WebUI. Для собственных сценариев — OpenAI SDK или обычный HTTP-клиент из документации.

• Определите, нужен ли клиенту именно OpenAI-совместимый протокол или нативный формат Anthropic/Gemini.
• Проверьте, какие функции (стриминг, инструменты, изображения) поддерживает выбранная модель.
• Создайте отдельный API-ключ под конкретную интеграцию, чтобы контролировать расход.

Почти любой клиент с поддержкой «OpenAI Compatible» просит три поля: Base URL, API Key и Model ID. Для NeuroAPI это https://neuroapi.host/v1, ключ из личного кабинета и точное имя модели из каталога.

Ключ создаётся в разделе «Токены» личного кабинета. Храните его как пароль: не публикуйте в репозиториях и не вставляйте в публичные конфиги. При компрометации ключ нужно отозвать и создать новый.

• Base URL: https://neuroapi.host/v1
• API Key: ключ NeuroAPI, созданный в /dashboard/tokens
• Model ID: точное имя из /price, например из карточки модели
• Проверка: GET /v1/models с тем же ключом

Ниже — пошаговые руководства для популярных клиентов. Названия пунктов меню могут отличаться в зависимости от версии приложения, поэтому сверяйтесь с официальной документацией клиента.

Если клиент поддерживает нативные форматы Anthropic или Gemini, для соответствующих моделей можно использовать нативные эндпоинты — они описаны в разделе «Форматы API».

• Cursor — OpenAI-совместимый провайдер и каталог моделей.
• Claude Code — установщик и переменные окружения для CLI.
• Codex CLI и Desktop — адрес, каталог моделей и проверка конфигурации.
• Cline и Roo Code — расширения VS Code с провайдером OpenAI Compatible.
• Open WebUI — Docker-развёртывание и подключение через настройки соединений.
• Continue — config.yaml с OpenAI-совместимым провайдером.
• n8n и LibreChat — автоматизация и self-hosted чат с кастомным endpoint.
• Telegram-бот — минимальный пример на aiogram и OpenAI SDK.

Если клиент возвращает 401, чаще всего неверен или отозван ключ. Ошибка 404 на модели обычно означает опечатку в Model ID или недоступность модели на выбранном тарифе. Ответ 429 говорит о превышении лимитов — их стоит проверить в документации и кабинете.

Если запрос уходит не туда, проверьте, не остался ли в клиенте старый base_url официального провайдера. Подробный разбор ошибок и правила повторов — в документации.

• 401 — проверьте ключ и заголовок Authorization: Bearer.
• 404 — сверьте Model ID с карточкой модели и тарифом ключа.
• 429 — проверьте лимиты, повторите позже с учётом правил клиента.
• Таймауты — проверьте стриминг и длительность ответа выбранной модели.

Каждая интеграция — это отдельный потребитель ключа. Заведите отдельный ключ на каждый клиент и тариф: так проще отозвать доступ, если ноутбук потерян или расширение удалено, и видно расход по конкретному инструменту.

Не сохраняйте ключ в репозитории, в публичных gist и в скриншотах. В корпоративном контуре используйте workspace-роли: разработчики работают с ключами, бухгалтерия видит документы, но не технические секреты. Для продакшена выпускайте отдельный ключ и ограничьте бюджет.

• Отдельный ключ на каждого сотрудника или сервис.
• Ротация при подозрении на утечку, а не после инцидента.
• Корпоративные роли отделяют финансы от технических доступов.
• Не публикуйте полный ключ в тикетах и чатах поддержки.