Den AfiniTwin Portable kann man seit ein paar Monaten vom Dashboard herunterladen. Es funktioniert: du kopierst das Preset, fügst es in Claude/ChatGPT/Gemini ein, und die KI spricht mit dir, als hätte sie dich seit der ersten Runde gekannt. Aber Kopieren-Einfügen skaliert nicht. Wenn deine B2B-Integration ernst gemeint ist — ein CRM, ein eigener Assistent, eine nächtliche Verarbeitungspipeline —, brauchst du etwas anderes: dass der AfiniTwin von selbst, programmatisch, in jedem Aufruf eintritt, den dein System ans LLM richtet.

Genau das veröffentlichen wir heute. Eine authentifizierte REST-API, die deinen AfiniTwin als System Prompt ausliefert, bereit zur Injektion aus dem Code, den du gerade schreibst.

Die minimale Geste

Ein Schlüssel, ein Aufruf:

curl -H "X-Twin-Key: atk_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" \
  "https://api.afini.ai/v1/public/twin/preset/estandar?format=json&lang=de"

Liefert den vollständigen Meta-Prompt des angeforderten Presets in dem angeforderten Format zurück. Du lädst ihn als system in deinem Anthropic / OpenAI / Mistral / wasauchimmer Client, und ab dann ist jede Runde auf dein kognitives Profil kalibriert. Ohne Nachtraining. Ohne Fine-Tuning. Ohne über unsere Infrastruktur zu gehen, abgesehen vom initialen Snapshot-Lesen.

Fünf Endpunkte, eine Idee

/v1/public/twin/health — ein Ping, um zu prüfen, ob der Schlüssel lebt, ohne monatliche Quote zu verbrauchen. Für deine Deployment Health Checks.

/v1/public/twin/me — Identität des Schlüssels, Plan des Besitzers, verbrauchte/verbleibende Quote, neuester verfügbarer Twin. Das, was du beim Booten deiner Integration aufrufen wirst, um Plan-Downgrade oder Schlüsselwiderruf zu erkennen.

/v1/public/twin/historic — Liste deiner Snapshots (einer pro AfiniTwin-Kauf oder pro vierteljährlich kostenlosem im Professional-Plan). Nützlich, wenn deine Integration den Nutzer aus mehreren wählen lassen will.

/v1/public/twin/snapshots/:id — Metadaten eines konkreten Snapshots.

/v1/public/twin/preset/:slug?format=...&lang=...&variant=...&includeNarratives=... — der Endpunkt mit Fleisch. Liefert das Artefakt in .txt, .md, .json oder .yaml, in sechs Sprachen, mit oder ohne integrierten Opus-Narrativen.

Alle Endpunkte außer /health zählen für die monatliche Quote. Standard 10.000 Anfragen/Monat, konfigurierbar bis 1 Million pro Schlüssel. Jede Antwort enthält X-Twin-Quota-{Limit,Used,Remaining}-Header, damit deine Integration weiß, wie viel ihr bleibt.

Warum API-Schlüssel, kein OAuth

OAuth wäre sinnvoll, wenn die Integration ein Dritter wäre, der auf das Profil eines anderen Nutzers zugreift. Das ist nicht der Fall. Die B2B-API liefert DEINEN AfiniTwin an DEINE Integration — dein CRM, dein Assistent, dein Agent. Ein persönlicher API-Schlüssel, in deinem Dashboard generiert, in den Vault deiner Integration kopiert, ist das passendste Modell: null Einwilligungsreibung, sofortiger Widerruf, ein Schlüssel pro Integration, damit der Blast Radius eines Lecks begrenzt ist.

Schlüssel sind Geheimnisse im starken Sinn: in der DB speichern wir nur den SHA-256-Hash (Format atk_live_<8 hex>_<32 hex>). Plaintext wird nur einmal bei Erstellung angezeigt. Wenn du ihn verlierst, widerrufe und erstelle einen neuen. Wenn du den Schlüssel versehentlich in einem öffentlichen Repo veröffentlichst — passiert, du bist nicht der Erste — widerrufe vom Dashboard und es ist in Millisekunden offline.

Professional-Plan, nicht aus Laune

Schlüsselgenerierung ist dem Professional-Plan vorbehalten (aktives Stripe-Abo oder lebender Professional-Voucher). Die öffentlichen Endpunkte liefern unterschiedslos, solange dein Schlüssel zur Einlösezeit auf einem Professional-Konto ausgestellt wurde. Wenn du herunterstufst, bleiben Schlüssel gespeichert, aber die Endpunkte geben 403 zurück, bis du wieder hochstufst. Wir löschen sie nicht — wir lassen sie pausiert, wartend.

Warum nicht Essential oder Premium? Weil B2B-Integrationen anhaltende Last auf unsere Infrastruktur bedeuten (der Snapshot lebt in unserer DB, die Header kommen von unserem Proxy), und die Grenzkosten pro Integration nur zum Professional-Preis aufgehen. Keine künstliche Beschränkung: ehrliche Ingenieurskunst.

Quote, Rate Limit, zwei Gürtel

Die monatliche Quote misst aggregiertes Volumen. Das IP/Schlüssel-Rate-Limit misst Bursts. Heute servieren wir dir 60 Anfragen pro Minute auf jedem schweren Endpunkt, 120 pro Minute auf /health. Wenn deine Integration eine versehentliche Endlosschleife erwischt, fängt das Rate-Limit sie ab, bevor deine monatliche Quote leerläuft. Defense in depth.

Was wir NICHT sind

Das ist kein „hol mir das Profil von Nutzer X"-Endpunkt, wo X jemand anders als der Schlüsselbesitzer ist. Der Schlüssel authentifiziert den Besitzer und gibt immer SEINEN AfiniTwin zurück. Keine Multi-Tenant-Pfade. Kein Remote-Admin.

Das ist auch kein Endpunkt, um Modelle auf Kosten des Nutzers zu trainieren. Was wir liefern, ist das, was bereits in seinem unveränderlichen Snapshot ist. Wenn unser Inferenz-Anbieter (Anthropic) seine Aufbewahrungspolitik ändert, wirkt sich das nicht rückwirkend auf bereits generierte Snapshots aus.

Und das ist kein Ersatz für Journaling, Coaching oder Therapie. Es ist eine technische Komponente für Integratoren. Menschliche Angelegenheiten bleiben menschlich.

Wie heute starten

1. Abonniere oder löse einen Professional-Voucher ein auf https://afini.ai/precios, wenn du ihn noch nicht hast.
2. Kaufe deinen AfiniTwin vom Dashboard, wenn nicht schon geschehen. Die API funktioniert ohne Twin (gibt 403 NO_TWIN_PURCHASED zurück), aber ohne Twin gibt es nicht viel zu liefern.
3. Generiere deinen ersten Schlüssel auf https://afini.ai/de/dashboard/twin/api. Kopiere ihn in den Vault deiner Integration. Committe ihn NICHT in ein Repo.
4. Rufe /v1/public/twin/health auf, um zu prüfen, dass er lebt. Verbraucht keine Quote.
5. Lies die vollständige Dokumentation auf https://afini.ai/de/afinitwin/api. cURL-, Node.js- und Python-Beispiele, vollständige Fehlertabelle, Sicherheitsempfehlungen.

Wenn dein Integrationsfall besondere Anforderungen hat — Quoten über 1M/Monat, spezifische Scopes, SLA-Support —, schreib an info@afini.ai. Es gibt Verhandlungsspielraum.

Ehrliche Roadmap

Heute (v1.0): die 5 Endpunkte oben, einziger Scope twin:read, Professional-Plan, Quote konfigurierbar bis 1M.

Nächste Wochen: Webhooks (dich benachrichtigen, wenn ein neuer Snapshot ready ist, kein Polling), Scope twin:write für Integrationen, die vitale Fakten setzen wollen (mit ausdrücklicher Zustimmung), Nutzungsmetriken vom Dashboard.

Wenn nötig: offizielles TypeScript- und Python-SDK, kanonische Integrationsbeispiele mit Anthropic und OpenAI, Enterprise-Plan mit SLA und Quoten über der Million.

Wir versprechen nichts, was nicht da ist. Wenn du es brauchst und es noch nicht da ist, sag's und es wird priorisiert.

— Ricardo