Einmal einlesen, für immer abfragen.

01 DREI MODI

Ein Endpunkt hinein. Zwei Endpunkte hinaus.

curl -X POST https://api.talonic.com/v1/extract \
  -H "Authorization: Bearer $TALONIC_API_KEY" \
  -F "file=@invoice.pdf"

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" },
      line_items: {
        type: "array",
        items: {
          type: "object",
          properties: {
            description: { type: "string" },
            amount_eur: { type: "number" }
          }
        }
      }
    },
    required: ["vendor", "total_eur"]
  }
});
// result.data == { vendor: "Acme Corp", total_eur: 1500.00, ... }
// Every field includes confidence and provenance.

{"type": "object", "properties": { ... }}

{"fields": [
  {"name": "vendor", "type": "string", "description": "..."}
]}

{"vendor": "string", "total": "number"}

# Typed rows over materialised field values. No model call, no credits.
POST /v1/documents/filter
{
  "conditions": [
    { "fieldId": "vendor_name",   "operator": "eq", "value": "Meridian Energy AG" },
    { "fieldId": "contract_year", "operator": "eq", "value": "2026" }
  ],
  "limit": 50
}

# A cited answer over the same corpus.
POST /v1/ask
{
  "question": "Which contracts renew in the next 30 days, and with what notice period?",
  "scope": { "pipeline_id": "pipe_contracts_2026" }
}
# -> rows + the SQL that produced them + an exact source span behind every claim

Dieselbe Authentifizierung, derselbe Response Envelope, derselbe Herkunftsnachweis. Wählen Sie den Modus, der zu dem Aufruf passt, den Sie schreiben.

02 AUTHENTIFIZIERUNG

Authentifizierung

Authorization: Bearer $TALONIC_API_KEY

Schlüssel im Dashboard verwalten →

03 KOSTEN & ABRECHNUNG

Die Abrechnungsgeschichte für Agenten.

Kosten bei jedem Aufruf ablesen

Jede synchrone /v1/extract Antwort enthält Kostenheader. Agenten verfolgen die Ausgaben pro Aufruf ohne separate Anfrage und können sehen, wie viele Zellen kostenlos aus der Datenbank stammten.

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: 1

Headers erscheinen bei synchronen 200-Antworten. Asynchrone 202-Poll-Antworten enthalten sie nicht.

Guthaben und Reichweite prüfen

Ein einzelner Endpunkt liefert aktuelles Guthaben, die 30-Tage-Burn-Rate und die geschätzte Reichweite in Tagen.

GET /v1/credits/balance

{
  "balance_credits": 64930,
  "balance_eur": 64.93,
  "burn_rate_30d_credits": 12400,
  "projected_runway_days": 157,
  "tier": "pro",
  "tier_resets_at": "2026-05-01T00:00:00Z"
}

Automatisches Aufladen (mit menschlicher Freigabe)

04 FEHLER & WIEDERHOLUNGEN

Fehler und Wiederholungen

Siehe die Fehlerreferenz für alle Fehlercodes, den Antwort-Envelope, Wiederholungshinweise und Backoff-Empfehlungen.

05 WEBHOOKS

Webhooks

06 SDKS & MCP

SDKs und MCP

npm install @talonic/node

import { Talonic } from "@talonic/node";

const client = new Talonic({
  apiKey: process.env.TALONIC_API_KEY!
});

{
  "mcpServers": {
    "talonic": {
      "url": "https://mcp.talonic.com/mcp",
      "headers": {
        "Authorization": "Bearer tlnc_live_..."
      }
    }
  }
}

{
  "mcpServers": {
    "talonic": {
      "command": "npx",
      "args": ["-y", "@talonic/mcp@latest"],
      "env": {
        "TALONIC_API_KEY": "tlnc_live_..."
      }
    }
  }
}

Das Node SDK und der MCP-Server sind schlanke Wrapper um dieselbe REST-API. Für andere Sprachen funktioniert die API direkt. Siehe die OpenAPI-Spezifikation oder direkt zu Mode 1 oben.

07 LIMITS

Limits und Metering

Talonic misst die Nutzung in Credits, nicht in Anfrage-Kontingenten. 1.000 Credits entsprechen einem Euro, bei jeder Paketgröße.

Kostenlos

5,000 credits/month, keine Kreditkarte nötig. Eine harte Obergrenze: 429 bis zum monatlichen Reset oder einer Aufladung.

Pay as you go

Prepaid-Credit-Pakete ab €10, Flatrate bei jeder Größe, kaufbar direkt in der App. Credits bleiben zwölf Monate gültig.

Enterprise

Volumenverträge, Rechnungsstellung, individuelle Kontingente.

Pro Vorgang: 100 Credits pro erfasster Seite · 20 pro KI-aufgelöster Zelle · 0 pro aus der Datenbank aufgelöster Zelle · 100 pro Matching- oder Case-Vorgang · Batch-Modus 0,5×.

08 UNTERSTÜTZTE FORMATE

Unterstützte Formate

25+ Formate für Dokumente, Bilder, Text und Archive. Deutsch, Englisch, Französisch und Spanisch in Produktionsqualität.

09 WARUM NICHT RAG

Warum nicht einfach RAG?

Weil die zweite Frage kostenlos sein sollte und dieselbe Frage morgen dieselbe Antwort liefern sollte. Drei veröffentlichte Benchmarks, eine Methode, wobei die Zeilen, die wir verlieren, mit aufgeführt sind.

Beim numerischen Lesen mit einer Frage pro Dokument liegen Structure-first und Retrieval in unseren eigenen Durchläufen gleichauf. Das steht so auf der Benchmark-Seite. Der Vorteil liegt bei der zweiten Frage und jeder danach.