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

Публичный API для B2B-интеграций с AI Консультант.

Доступ

Ключ API выдаётся администратором платформы. Передавайте его в заголовке каждого запроса:

Authorization: Bearer sk_live_...

Лимит: 60 запросов в минуту на ключ. Квота вопросов — персональная для каждого ключа, задаётся при выдаче.

Ограничения текущей версии

API работает в режиме «один вопрос — один ответ», без памяти о предыдущих сообщениях и без потоковой передачи ответа. Каждый запрос к специалисту — независимая консультация.

GET /api/v1/specialists

Список доступных специалистов.

curl https://ai.tuwkan4ik.com/api/v1/specialists \
  -H "Authorization: Bearer sk_live_..."
[
  { "slug": "lawyer", "name": "AI-Юрист", "title": "...", "description": "...", "category": "..." },
  ...
]

GET /api/v1/usage

Текущий расход квоты по ключу.

curl https://ai.tuwkan4ik.com/api/v1/usage \
  -H "Authorization: Bearer sk_live_..."
{ "label": "ООО Ромашка", "questionsUsed": 12, "questionsLimit": 1000, "remaining": 988, "active": true }

POST /api/v1/consult

Задать вопрос специалисту.

curl -X POST https://ai.tuwkan4ik.com/api/v1/consult \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"specialistSlug": "lawyer", "question": "...", "lang": "ru"}'
{ "answer": "..." }

Параметры: specialistSlug (обязателен) — из списка /api/v1/specialists; question (обязателен, до 4000 символов); lang (необязателен, «ru» или «en»).

Коды ошибок

  • 401 — неверный или отсутствующий ключ
  • 400 — некорректный запрос (нет обязательных полей, вопрос слишком длинный)
  • 404 — неизвестный specialistSlug
  • 403 — квота по ключу исчерпана
  • 429 — превышен лимит запросов в минуту
  • 502 — временный сбой при обращении к AI, повторите запрос
Документация API — AI Консультант