RUEN

Janus.Guru

API для ассистентов по документам

API подключает Janus.Guru к порталам, внутренним системам, Telegram-ботам, CRM, редакционным инструментам и рабочим панелям.

Запустить пилотОткрыть демо

Публичные методы

  • GET /api/corpora – список доступных корпусов
  • POST /api/source-refs – быстрый поиск источников
  • POST /api/ask – синхронный ответ
  • POST /api/ask/stream – потоковый ответ через SSE

Машинные входы

  • OpenAPI доступен по /api/openapi.json
  • LLM-контекст доступен по /llms.txt и /llms-full.txt
  • публичная декларация потребителя QazStack доступна по /.well-known/qazstack-consumer.json
  • виджет подключается через /widget/janus.js

Быстрый старт интеграции

От корпуса к ответу с источниками

Начните без ключа в публичном контуре. Если для внедрения выдан ключ с ограничениями, добавьте необязательный заголовок x-api-key.

01

Выберите корпус

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

curl -s https://janus.guru/api/corpora
02

Сначала найдите источники

Режим только поиска помогает проверить основания до генерации ответа.

curl -s https://janus.guru/api/source-refs \
  -H 'content-type: application/json' \
  -d '{"query":"Какие статьи посвящены правам человека?","corpus_id":"krk_2026","limit":5}'
03

Задайте вопрос или включите поток

Для JSON используйте /api/ask, для SSE – /api/ask/stream.

curl -s https://janus.guru/api/ask \
  -H 'content-type: application/json' \
  -H 'x-api-key: $JANUS_API_KEY' \
  -d '{"query":"Какие статьи посвящены правам человека?","corpus_id":"krk_2026"}'

curl -N https://janus.guru/api/ask/stream \
  -H 'content-type: application/json' \
  -d '{"query":"Какие статьи посвящены правам человека?","corpus_id":"krk_2026"}'
Контракт ответа

Ответ содержит request_id, mode, lang, latency_ms, source_refs и sources. Перед внешним использованием откройте каждый источник.

Открыть машинно-читаемую схемуИнтеграция виджета

Частые вопросы

  • Где находится OpenAPI схема?
    Машинно-читаемый OpenAPI доступен по адресу https://janus.guru/api/openapi.json.
  • Можно ли встроить Janus.Guru в существующую систему?
    Да. Для интеграций доступны HTTP API, потоковый ответ через SSE и отдельная страница документации API.