Документация

Шлюз совместим с OpenAI и Anthropic: меняете базовый адрес и ключ — остальной код остаётся прежним.

Подключение

OpenAI-совместимый

base_url = "https://neural-api.ru/v1"
api_key  = "sk-…"

Работают /v1/chat/completions, /v1/models, /v1/images/generations.

Anthropic-совместимый

base_url = "https://neural-api.ru/anthropic"
api_key  = "sk-…"

Заголовки: x-api-key и anthropic-version: 2023-06-01.

Готовые клиенты

Cherry Studio

Вставить base URL и ключ в настройках провайдера.

AionUI

Добавить провайдера OpenAI-совместимого типа.

CC Switch

Новый профиль с адресом шлюза и ключом.

DeepChat

Указать endpoint и токен в настройках подключения.

Скачать готовый скрипт настройки для CLI-клиентов: neural-setup.cjs.

Модели

Полный список с идентификаторами — на странице модели. Актуальные цены и лимиты — в кабинете.

Правила выбора

Идентификатор модели подставляется в поле model. Модели изображений работают только через /v1/images/generations — чат-запрос к ним не вернёт результат.

Шлюз обращается к моделям по их собственным API. Имя модели в ответе соответствует запрошенному — подмены моделей нет.

Доступ из России

Часть российских сетей и мобильных операторов режет IPv4-адреса зарубежных хостингов: TCP-соединение устанавливается, но данные не проходят. Мы столкнулись с этим на собственном IP и закрыли вопрос через IPv6.

Как это работает

В DNS всех наших доменов есть AAAA-запись 2a01:e5c0:5c99::2, и сервер слушает IPv6 на 80 и 443. Если ваша сеть поддерживает IPv6 — соединение идёт напрямую, без посредников.

Проверить наличие IPv6: ping -6 neural-api.ru

Если IPv6 нет

Без глобального IPv6 адрес 103.229.31.59 может быть недоступен — это зависит от маршрута вашего провайдера, и мы на это повлиять не можем.

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

Сервер и все API работают нормально — проблема строго на сетевом пути между вашим провайдером и дата-центром.

Диагностика

Если что-то не работает — идите по шагам сверху вниз.

Проверить DNS

nslookup neural-api.ru 1.1.1.1 — в ответе должен быть IPv6-адрес 2a01:e5c0:5c99::2. Если его нет — проблема в DNS-зоне, напишите в поддержку.

Проверить IPv6

ping -6 neural-api.ru — должен ответить. Нет ответа — IPv6 в вашей сети не работает, см. раздел выше.

Проверить HTTPS

curl -6 -I https://neural-api.ru/ — ожидается 200. Если 000 — соединение режется на пути.

Проверить ключ

Откройте страницу проверки — она покажет статус ключа, остаток и доступные модели.

Проверить API напрямую

curl https://neural-api.ru/v1/models -H "Authorization: Bearer sk-…" — в ответе должен быть JSON со списком моделей.

Частые ошибки

401 — неверный ключ или истёкший срок.
429 — превышен лимит запросов.
model_not_found — модели нет в списке моделей.
quota — кончился баланс ключа.

Поддержка

Через FunPay или в личном кабинете. Приложите вывод команд из шагов выше — так быстрее разберёмся.

Покупка и пополнение — на странице оплаты.