RUEN

Janus.Guru

An API for document assistants

Use Janus.Guru from portals, internal systems, Telegram bots, CRMs, editorial tools, and operational dashboards.

Launch a pilotOpen demo

Public methods

  • GET /api/corpora – available collections
  • POST /api/source-refs – fast source lookup
  • POST /api/ask – synchronous answer
  • POST /api/ask/stream – SSE answer stream

Machine interfaces

  • OpenAPI: /api/openapi.json
  • LLM context: /llms.txt and /llms-full.txt
  • QazStack consumer contract: /.well-known/qazstack-consumer.json
  • Widget loader: /widget/janus.js

Integration quick start

From collection to a source-backed answer

Start without a key on the public contour. Add the optional x-api-key header when a deployment gives you a scoped key.

01

Choose a collection

Read active collection identifiers before sending a question.

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

Inspect sources first

Use retrieval-only mode to check evidence without generating an answer.

curl -s https://janus.guru/api/source-refs \
  -H 'content-type: application/json' \
  -d '{"query":"Which articles cover human rights?","corpus_id":"krk_2026","limit":5}'
03

Ask and stream

Use /api/ask for JSON or /api/ask/stream for SSE events.

curl -s https://janus.guru/api/ask \
  -H 'content-type: application/json' \
  -H 'x-api-key: $JANUS_API_KEY' \
  -d '{"query":"Which articles cover human rights?","corpus_id":"krk_2026"}'

curl -N https://janus.guru/api/ask/stream \
  -H 'content-type: application/json' \
  -d '{"query":"Which articles cover human rights?","corpus_id":"krk_2026"}'
Response contract

The answer includes request_id, mode, lang, latency_ms, source_refs, and sources. Open each source before external use.

Open the machine-readable schemaWidget integration

Frequently asked questions

  • Where is the OpenAPI schema?
    The machine-readable schema is available at https://janus.guru/api/openapi.json.
  • Can Janus.Guru connect to an existing system?
    Yes. HTTP API, SSE, and the embeddable widget cover common integration paths.