API

cd backend && uv run rag-token --email вы@example.com --days 365

curl -X POST https://ваш-хост/api/v1/answer \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"question": "сколько дней отпуска?"}'

curl -H "Authorization: Bearer $TOKEN" https://ваш-хост/api/v1/me
# {"user_id":"db8122ef-4ce8-4dce-a3d4-d6b0ab53cf08"}

{
  "answer": "Основной отпуск — 28 календарных дней [1].",
  "citations": [
    {
      "n": 1,
      "document_id": "0f0f9d3c-9c4e-4f4b-9d61-0b1d1c1c1c1c",
      "filename": "Политика.pdf",
      "page": 3,
      "url": null,
      "snippet": "28 календарных дней…"
    }
  ],
  "steps": [{ "tool": "search_knowledge", "query": "отпуск дней политика" }],
  "usage": {
    "prompt_tokens": 5000,
    "completion_tokens": 60,
    "total_tokens": 5060,
    "cost_usd": 0.00133215,
    "cost_complete": true,
    "calls": 3,
    "stages": [
      { "stage": "rerank", "model": "google/gemini-2.5-flash-lite", "calls": 2,
        "prompt_tokens": 1900, "completion_tokens": 22, "cost_usd": 0.0002269 },
      { "stage": "answer", "model": "openai/gpt-5-mini", "calls": 1,
        "prompt_tokens": 3100, "completion_tokens": 38, "cost_usd": 0.00110525 }
    ]
  },
  "took_ms": 6227,
  "chat_id": null,
  "message_id": null
}

const response = await fetch("https://ваш-хост/api/v1/answer", {
  method: "POST",
  headers: { Authorization: `Bearer ${TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({ question: "что у меня по проекту?", stream: true }),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = "";

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });

  const frames = buffer.split("\n\n");
  buffer = frames.pop() ?? "";
  for (const frame of frames) {
    const [head, body] = frame.split("\n");
    const event = head.replace("event: ", "");
    const data = JSON.parse(body.replace("data: ", ""));
    if (event === "token") process.stdout.write(data);
    if (event === "done") console.log(data.citations, data.usage.cost_usd);
  }
}

curl -X POST https://ваш-хост/api/v1/verify \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"text": "Основной отпуск — 28 дней, заявление за три месяца."}'

curl -G https://ваш-хост/api/v1/search \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "q=вишлист" --data-urlencode "limit=5"

{
  "hits": [
    {
      "document_id": "0f0f…",
      "filename": "Заметки.md",
      "page": null,
      "snippet": [
        { "text": "добавил в ", "hit": false },
        { "text": "вишлисте", "hit": true },
        { "text": " наушники", "hit": false }
      ]
    }
  ],
  "found": 20,
  "took_ms": 96
}

curl -X POST https://ваш-хост/api/v1/documents \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@Политика.pdf"

curl -X POST https://ваш-хост/api/v1/documents/url \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/статья"}'

CHAT=$(curl -sX POST https://ваш-хост/api/v1/chats \
  -H "Authorization: Bearer $TOKEN" | jq -r .id)

curl -X POST https://ваш-хост/api/v1/answer \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d "{\"question\": \"а что там по срокам?\", \"chat_id\": \"$CHAT\"}"

from openai import OpenAI

client = OpenAI(base_url="https://ваш-хост/api/v1", api_key=TOKEN)

done = client.chat.completions.create(
    model="grounded",  # grounded-web — с поиском в интернете
    messages=[{"role": "user", "content": "сколько дней отпуска?"}],
)
print(done.choices[0].message.content)
print(done.usage.model_extra["cost"], done.model_extra["citations"])