Wir kündigen die AfiniTwin-API für Integratoren an

Fünf REST-Endpunkte mit API-Schlüssel authentifiziert. Liefere deinen AfiniTwin als System Prompt aus deinem CRM, eigenen Assistenten oder nächtlichen Pipeline aus. In deinem afini.ai-Abo enthalten. Heute.

I. Die minimale Geste

Den AfiniTwin Portable kann man seit ein paar Monaten vom Dashboard herunterladen. Es funktioniert: du kopierst das Preset, fügst es in Claude, ChatGPT oder Gemini ein, und die KI spricht mit dir, als hätte sie dich seit der ersten Runde gekannt. Aber Kopieren und 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.

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- oder beliebigem 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.

System Prompt, def.: die Art, wie ein LLM sich daran erinnert, wer er ist, bevor er vergisst, wer du bist. Die B2B-API kümmert sich darum, ihm die Erinnerung an dich zu bewahren.

II. 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 und 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 für jeden AfiniTwin, den dein Abo Monat für Monat erzeugt. 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 zehntausend Anfragen pro Monat, konfigurierbar bis eine Million pro Schlüssel. Jede Antwort enthält X-Twin-Quota-{Limit,Used,Remaining}-Header, damit deine Integration weiß, wie viel ihr bleibt, ohne raten zu müssen.

III. 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.

API-Schlüssel, def.: ein Geheimnis, das seinen Status als Geheimnis genau zwischen der Zeile, in der es generiert wird, und dem ersten Mal beibehält, in dem es jemand unachtsam in ein öffentliches Repository einfügt. Deshalb ist der Widerruf schnell.

Schlüssel sind Geheimnisse im starken Sinn: in der Datenbank 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.

IV. Teil deines Abos

Schlüsselgenerierung ist in deinem afini.ai-Abo enthalten, entweder per aktivem Stripe-Abo oder per lebendem Voucher. Die öffentlichen Endpunkte liefern unterschiedslos, solange dein Schlüssel auf einem Konto mit aktivem Abo ausgestellt wurde. Wenn dein Abo ausläuft, bleiben Schlüssel gespeichert, aber die Endpunkte geben 403 zurück, bis du es reaktivierst. Wir löschen sie nicht — wir lassen sie pausiert, wartend.

Die API ist ein weiteres Feature des Abos, kein Extra, das man separat kauft. B2B-Integrationen bedeuten anhaltende Last auf unsere Infrastruktur — der Snapshot lebt in unserer Datenbank, die Header kommen von unserem Proxy — und das ist bereits von der monatlichen Quote abgedeckt. Kein Kleingedrucktes: wenn du abonniert bist, hast du sie.

V. Quote und Rate Limit: zwei Gürtel

Die monatliche Quote misst aggregiertes Volumen. Das Rate Limit pro IP und Schlüssel misst Bursts. Heute servieren wir dir sechzig Anfragen pro Minute auf jedem schweren Endpunkt, hundertzwanzig pro Minute auf /health. Wenn deine Integration eine versehentliche Endlosschleife erwischt, fängt das Rate Limit sie ab, bevor deine monatliche Quote leerläuft. Keine einschichtige Sicherheit.

Monatliche Quote, def.: zeitweilige Gnade, die die Infrastruktur dem nachlässigen Integrator gewährt, ausgedrückt in Anfragen. Sie erneuert sich am Ersten; am Zweiten beginnt die Prüfung von vorn.

VI. 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.

VII. Wie heute starten

1. Abonniere oder löse deinen Voucher ein auf https://afini.ai/precios, wenn noch nicht geschehen.
2. Erzeuge deinen AfiniTwin vom Dashboard, wenn du ihn noch nicht hast. 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 eine Million pro Monat, spezifische Scopes, SLA-Support —, schreib an info@afini.ai. Es gibt Verhandlungsspielraum.

VIII. Ehrliche Roadmap

Heute (v1.0): die fünf Endpunkte oben, einziger Scope twin:read, im afini.ai-Abo enthalten, Quote konfigurierbar bis eine Million.

Nächste Wochen: Webhooks, um dich zu benachrichtigen, wenn ein neuer Snapshot ready ist — ohne Polling —, Scope twin:write für Integrationen, die vitale Fakten mit ausdrücklicher Zustimmung setzen wollen, 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