Für Entwickler
Einmal einlesen, dauerhaft abfragen.
Drei Modi, eine API. Alles in einem Dokument extrahieren, genau die Struktur extrahieren, die Sie senden, oder das Dokument überspringen und abfragen, was Sie letzten Monat gelesen haben.
curl -X POST https://api.talonic.com/v1/extract \
-H "Authorization: Bearer $TALONIC_API_KEY" \
-F "file=@invoice.pdf"5.000 Credits pro Monat kostenlos. Keine Kreditkarte erforderlich.
Alles extrahieren. Dokument senden, jedes Feld mit Konfidenz und Herkunft erhalten. Kein Schema nötig.
Ihre Struktur extrahieren. JSON Schema senden, genau diese Struktur zurückerhalten, validiert, mit Konfidenz pro Feld.
Die Datenbank abfragen. Typisierte Zeilen ohne Modellaufruf oder eine belegte Antwort, über alles, was Sie bereits gelesen haben.
01 · Extrahieren
Modus 1: alles extrahieren.
Verwenden Sie ihn, wenn Sie noch nicht wissen, was im Dokument steht. Jedes Feld kommt mit seiner Konfidenz und dem Bereich zurück, aus dem es stammt.
- Ein Aufruf: POST /v1/extract, synchron oder asynchron.
- Jeder Wert mit Quelle: Seite, Bereich, Konfidenz und die Phase, die ihn befüllt hat.
- Registry-Treffer sind kostenlos: Zellen, die aus der Datenbank aufgelöst werden, kosten keine Credits.
02 · Ihr Schema
Modus 2: extrahieren Sie genau das, was Sie angefragt haben.
Nutzen Sie ihn, wenn Ihr Code bereits die benötigte Struktur kennt, also immer dann, wenn ein Agent eine Funktion aufruft.
- Drei Formate: vollständiges JSON Schema, vereinfachte Felder (empfohlen) oder eine flache Schlüssel-Typ-Zuordnung.
- Validiert: Pflichtfelder, Typen und Einschränkungen werden geprüft, bevor Sie das Ergebnis erhalten.
- Konfidenzwert pro Feld, damit Ihr Code entscheidet, wem er vertraut.
const result = await client.extract({
file_path: "invoice.pdf",
schema: {
type: "object",
properties: {
vendor: { type: "string" },
total_eur: { type: "number" },
due_date: { type: "string", format: "date" }
},
required: ["vendor", "total_eur"]
}
});
// result.data → { vendor: "Acme Corp", total_eur: 1500, ... }03 · Abfrage
Modus 3: Fragen Sie die Datenbank, statt das Dokument zu öffnen.
Die Dokumente wurden vor Tagen oder Monaten gelesen. Die Antwort steckt bereits in Ihren Daten: Erhalten Sie sie als Zeilen oder als belegte Antwort.
- POST /v1/documents/filter: typisierte Zeilen über Feldwerte. Kein Modellaufruf, keine Credits.
- POST /v1/ask: eine Frage in natürlicher Sprache, beantwortet mit Zeilen, der zugrunde liegenden SQL und einer Quellspanne pro Aussage.
- Umfang: beschränken Sie jede Frage auf eine Pipeline, eine Spezifikation oder eine Gruppe von Dokumenten.
POST /v1/ask
{
"question": "Which contracts renew in the next 30 days?",
"scope": { "pipeline_id": "pipe_contracts_2026" }
}04 · Auth
Authentifizierung.
Bearer-Schlüssel, eingeschränkt und widerrufbar. Legen Sie pro Integration einen Schlüssel an, damit jeder einzeln rotiert werden kann.
- Schlüssel: tlnc_-Präfix, wird als Authorization: Bearer übergeben, gehasht gespeichert und nur einmal angezeigt.
- Scopes: Ein Aufruf außerhalb des Scopes eines Schlüssels gibt 403 mit reason insufficient_scope und dem benötigten Scope zurück.
- Idempotenz: Senden Sie bei Schreibvorgängen einen Idempotency-Key mit, dann entsteht bei einem Wiederholungsversuch nie ein Duplikat.
curl https://api.talonic.com/v1/documents \
-H "Authorization: Bearer tlnc_..." \
-H "Idempotency-Key: 7f3c..."05 · Kosten
Kosten bei jedem Aufruf.
Agenten können ihr Budget planen, bevor sie laufen. Jede synchrone Extraktion gibt ihre Kosten in den Antwort-Headern zurück.
- Pro Aufruf: verbrauchte Credits, Euro, verbleibendes Guthaben und wie viele Zellen kostenlos aus der Datenbank stammen.
- Guthaben: Ein Endpunkt liefert Guthaben, Verbrauch der letzten 30 Tage und Restlaufzeit in Tagen.
- Automatisches Aufladen, mit menschlicher Freigabe: Eine Person aktiviert es; erst dann kann ein Agent aufladen.
HTTP/1.1 200 OK
X-Talonic-Cost-Credits: 70
X-Talonic-Cost-EUR: 0.07
X-Talonic-Balance-Credits: 64930
X-Talonic-Cells-Resolved-Registry: 0
X-Talonic-Cells-Resolved-AI: 106 · Fehler
Fehler, auf die Sie reagieren können.
Jeder Fehler hat dieselbe Struktur. Werten Sie zuerst reason aus, falls vorhanden, dann code. Wiederholen Sie nur, was als wiederholbar markiert ist.
- Stabile Token: Codes in UPPER_SNAKE, dazu ein kleingeschriebenes reason bei Ablehnungen.
- Sicher wiederholen: das Flag retryable, exponentieller Backoff und ein Idempotency-Key bei Aufrufen, die Daten anlegen.
- Support-bereit: jeder Fehler enthält eine request_id.
{
"statusCode": 403,
"code": "INSUFFICIENT_PERMISSIONS",
"reason": "insufficient_scope",
"retryable": false,
"request_id": "b6f1c2e0-..."
}07 · Webhooks
Webhooks und Zustellung.
Asynchrone Extraktionen und Zustellungsereignisse lösen signierte Webhooks aus. Alternativ verzichten Sie auf den Webhook und liefern direkt in Speicher- und Business-Anwendungen.
- Signiert: HMAC-SHA256, mit Signatur, Idempotency-Key, Versuchsnummer und Event-ID in den Headern.
- Wiederholt: sieben Versuche über etwa zehn Stunden, pro Binding überschreibbar.
- Wiederholbar: endgültige Fehler landen in einer Dead-Letter-Queue, die Sie erneut verarbeiten können.
- Ziele: SFTP, S3, Azure Blob, Google Drive, Google Sheets, OneDrive, SharePoint, Gmail, Outlook.
08 · SDK & MCP
Node SDK und MCP-Server.
Dünne Wrapper um dieselbe REST-API. Für jede andere Sprache generieren Sie einen Client aus der OpenAPI-Spezifikation.
- Node SDK: npm install @talonic/node.
- MCP-Server: gehostet unter mcp.talonic.com, nichts zu installieren. Auf Claude.ai meldet er sich per OAuth an, ohne Schlüssel in der Konfiguration.
- Tools für Agenten: Extraktion, OCR nach Markdown, Suche, Filter nach Feld, Dokument abrufen, Schemas sowie Guthaben und Nutzung, damit ein Agent planen kann.
- In der Produktion: Fixieren Sie eine Version, damit kein Release ein Tool verändern kann, auf das Ihr Agent angewiesen ist.
SDK-Dokumentation →MCP-Dokumentation →OpenAPI-Spezifikation →
{
"mcpServers": {
"talonic": {
"url": "https://mcp.talonic.com/mcp",
"headers": { "Authorization": "Bearer tlnc_..." }
}
}
}npm install @talonic/node09 · Limits
Limits und Abrechnung.
Die Nutzung wird in Credits abgerechnet, nicht über Anfragekontingente. 1.000 Credits kosten bei jeder Paketgröße einen Euro.
- Pro Vorgang: 200 Credits pro gelesener Seite, 20 pro KI-aufgelöster Zelle, 0 pro Zelle aus der Datenbank. Der Batch-Modus kostet die Hälfte.
- Tägliche Anfragelimits pro Tarif und Endpunktfamilie. Eine 429-Antwort gibt an, wann der Zähler zurückgesetzt wird.
- Dateigröße: 20 MB im Free-Tarif, 100 MB im Pro-Tarif, 500 MB im Enterprise-Tarif.
10 · Formate
25+ Formate als Eingabe.
Dokumente, Bilder, Text und Archive. Deutsch, Englisch, Französisch und Spanisch in Produktionsqualität.
11 · Warum nicht RAG
Warum nicht einfach RAG?
Denn die zweite Frage sollte nichts kosten, und dieselbe Frage sollte morgen dieselbe Antwort liefern. Drei veröffentlichte Benchmarks, inklusive der Niederlagen.
12 · Ressourcen
Ressourcen.
Alles, was Sie zum Bauen brauchen, an einem Ort.
Bringen Sie Ihren ersten Call noch heute live.
Registrieren Sie sich, erstellen Sie einen tlnc_-Schlüssel und gehen Sie in fünf Minuten live. 5,000 Credits pro Monat kostenlos.
Kostenlosen API-Schlüssel erhalten30 Minuten mit einem Implementierungsspezialisten oder Senior Engineer zu Ihrer Integration.
Termin buchen