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

Аутентификация

Все запросы к API требуют токен сессии. Получите его через авторизацию:

POST /api/auth/login
Content-Type: application/json

{
  "email": "you@example.com",
  "password": "your-password"
}

→ Устанавливает cookie сессии (httpOnly)
→ Или используйте: Authorization: Bearer {token}

Поиск

POST /api/search

Отправляет запрос нескольким AI-моделям с веб-поиском. Возвращает NDJSON-стрим.

Тело запроса

Стоимость в кредитах

Ответ (NDJSON-стрим)

{"type":"answer","modelId":"openai","modelName":"ChatGPT","text":"..."}
{"type":"answer","modelId":"gemini","modelName":"Gemini","text":"..."}
{"type":"error","modelId":"grok","modelName":"Grok","message":"..."}
{"type":"confidence","score":4,"total":5,"label":"high"}
{"type":"summary","text":"...","moderatorName":"Grok"}
{"type":"complete","queryId":42}

Пример (curl)

curl -X POST https://neuroverdict.com/api/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "query": "React vs Vue для SEO",
    "models": ["openai", "gemini", "perplexity"],
    "mode": "basic"
  }'

Классификация запроса

GET /api/search/classify?q={query}

Анализирует сложность запроса и рекомендует количество моделей.

GET /api/search/classify?q=столица+Бразилии

→ {"complexity":"simple","suggestedModels":2,"reason":"factual"}

Баланс и тарифы

GET /api/payments/balance — Баланс кредитов

GET /api/payments/plans — Список тарифов (публичный)

GET /api/payments/subscription — Текущая подписка

История запросов

GET /api/history — Список запросов

GET /api/history/:id — Результат с ответами моделей

POST /api/history/:id/share — Создать публичную ссылку

GET /api/history/shared/:token — Публичный результат (без авторизации)

Лимиты запросов

Коды ошибок