90-Sekunden-Quickstart
Vom API-Key zum ersten Citation-Response in unter 90 Sekunden. TypeScript- und cURL-Beispiele.
Voraussetzung: API-Key. Falls noch nicht vorhanden — /sign-up?plan=api (kostenfrei, ohne Kreditkarte, 100k Embeddings + 10k Queries pro Monat im Free-Tier).
1. SDK installieren
# TypeScript / Node.js
npm install @anirag/sdk
# oder Python
pip install anirag2. Erste Collection erstellen + Dokument hochladen
import { Anirag } from "@anirag/sdk";
const client = new Anirag({ apiKey: process.env.ANIRAG_API_KEY });
// Collection anlegen
const collection = await client.collections.create({
name: "Wartungs-Docs",
embedding_model: "voyage-3",
region: "eu-fra",
});
// Dokument hochladen (PDF, DOCX, URL, Markdown)
await client.docs.upload({
collection_id: collection.id,
file: "./handbuch-hx2400.pdf",
});3. Erste Query absetzen
const result = await client.query({
collection_id: collection.id,
question: "Wie wechsle ich die Hydraulikflüssigkeit an Maschine HX-2400?",
llm: "claude-haiku-4-5", // oder "claude-sonnet-4-6", "gpt-4", "mistral-large"
include_sources: true,
});
console.log(result.answer);
// → "Verwende ausschließlich Mineralöl HLP 46 ..."
console.log(result.citations);
// → [{ source: "handbuch-hx2400.pdf", page: 47, chunk_id: "...", score: 0.92 }]
console.log(result.cost_eur);
// → 0.0042 (transparent abgerechnet)Was als Nächstes
- Architektur & Datenfluss — verstehen, was hinter der Query passiert
- Query-Endpoint — vollständige Parameter-Referenz
- SDK-Referenz — TypeScript- und Python-Methoden im Detail
- Webhooks — asynchrone Events bei langen Indexing-Jobs