Vorschau · Die API ist in Vorbereitung
Stabily in deiner Plattform – mit wenigen Zeilen Code
Deine Lehrkräfte sind bei dir schon angemeldet? Dann nutzen sie Stabily sofort, ohne zweites Konto. Unser KI-Konfliktcoach kommt als einfache Web-API zu dir.
- REST + JSON
- Server in der EU
- OpenAPI (geplant)
Schon heute
Was Stabily heute schon kann
Alles, was du hier siehst, läuft bereits für Lehrkräfte auf stabily.ai. Über die API kommt es nach und nach zu dir.
- Live in Stabily
KI-Konfliktcoach
Lehrkräfte beschreiben eine schwierige Situation, Stabily ordnet sie ein und schlägt nächste Schritte vor – gestützt auf eine kuratierte Wissensbasis, mit Quellenangabe.
Per API zum Start
- Live in Stabily
Geführtes Erstgespräch
Bei einem neuen Fall fragt Stabily zuerst die wichtigsten Eckdaten ab, damit die Empfehlung wirklich passt.
Per API später
- Live in Stabily
Handlungsplan
Aus dem Gespräch entsteht ein Plan mit Lage, Einordnung und nächsten Schritten, auch als PDF zum Mitnehmen.
Per API zum Start
- Live in Stabily
Arbeitsblätter
Passende Arbeitsblätter ansehen, herunterladen oder von Stabily für die eigene Klasse anpassen lassen.
Per API später
- Live in Stabily
Namen ersetzen
Schreibt jemand echte Namen, ersetzt Stabily sie automatisch durch „Person A“, „Person B“ und so weiter.
Immer dabei
- Live in Stabily
Sicherheit zuerst
Erkennt Stabily Hinweise auf eine Krise, erscheint ein Notfall-Hinweis mit dem Notruf 112 und den Anlaufstellen.
Immer dabei
- Live in Stabily
Diktieren und Sprachmodus
Fragen per Sprache stellen oder ganz mit Stabily sprechen, direkt im Browser.
Per API später
- Live in Stabily
KI und Server in der EU
Die Antworten erzeugen KI-Modelle von Mistral AI in der EU, unsere Server-Funktionen laufen in Frankfurt am Main.
Immer dabei
In drei Schritten
So einfach geht's
Deine Lehrkräfte melden sich nur bei dir an. Dein Server spricht mit unserem, und Stabily ist sofort da.
- Schritt 1
Schlüssel holen
Du bekommst einen API-Schlüssel für deinen Server. Er bleibt dort und kommt nie in den Browser.
- Schritt 2
Lehrkraft durchreichen
Dein Server schickt eure interne ID der Lehrkraft mit. Kein Name, keine E-Mail, kein zweites Login.
- Schritt 3
Coach fragen
Frage rein, Antwort raus: mit Quellen, Rückfragen und, wenn nötig, einem Sicherheitshinweis.
Zum Ausprobieren
Vier Anfragen, die du am häufigsten brauchst
Wähl eine Anfrage und eine Variante, schau dir den Code an, ändere ihn und schick ihn ab. Die Antworten sind Beispiele: Hier geht nichts an einen Server, du kannst nichts kaputt machen.
Anfrage wählen
Ohne zweites Login starten
POSThttps://api.stabily.ai/v1/sessions
Was passiert hier?
Deine Lehrkraft ist bei dir schon angemeldet. Dein Server fragt bei Stabily einen Einmal-Link an und schickt sie dorthin: Sie landet direkt im Chat, ohne Konto und ohne Passwort bei uns. Als „user“ schickst du eure interne ID, nie eine E-Mail-Adresse oder einen Namen.
Variante
Die Lehrkraft nutzt Stabily zum ersten Mal: Wir legen sie still im Hintergrund an.
curl -X POST "https://api.stabily.ai/v1/sessions" \
-H "Authorization: Bearer $STABILY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"user": "lehrkraft-48151",
"return_url": "https://deine-plattform.example/kurse/7b"
}'Probier es aus: Lösch ein Pflichtfeld wie „user“, schreib eine E-Mail-Adresse hinein oder füg ein unbekanntes Feld hinzu.
Antwort
Demo-Antwort – keine echte AnfrageDrück auf „Anfrage senden“, dann siehst du hier, was die API zurückschickt.
Fehler verstehen
Wenn etwas schiefgeht
Jeder Fehler sagt klar, auf wessen Seite er liegt und was jetzt zu tun ist. Liegt er bei uns, versucht es unser System selbst noch einmal, protokolliert ihn und informiert unser Team – du musst nichts melden.
Fehler auf unserer Seite
Nicht dein Fehler: Wir sind schon dran. Merk dir die „incident_id“, falls du nachfragen willst, und versuch es nach „Retry-After“ noch einmal.
- Fehler erkanntUnser Server merkt sofort, dass etwas nicht stimmt.
- Automatisch wiederholtEr versucht es selbst noch einmal, bevor du etwas davon merkst.
- ProtokolliertKlappt es nicht, landet der Fehler mit einer Kennung in unserem Protokoll.
- Team informiertUnser Team bekommt Bescheid und kümmert sich darum.
So antwortet die API500 Internal Server Error
Retry-After: 30
{
"error": {
"type": "server_error",
"code": "internal_error",
"message": "Bei uns ist etwas schiefgelaufen – nicht bei dir. Wir haben es automatisch noch einmal versucht, den Fehler protokolliert und unser Team informiert. Du musst nichts melden.",
"incident_id": "inc_7F3KQ9",
"retryable": true,
"retry_after": 30,
"logged": true,
"team_notified": true
}
}Eingebaut, nicht abschaltbar
Sicherheit kommt zuerst
Erkennt Stabily Hinweise auf eine Krise, trägt die Antwort einen Notfall-Hinweis. Deine App zeigt ihn immer vollständig an, so wie im Stabily-Chat.
- Das Feld „safety“ lässt sich nicht abschalten.
- Echte Namen ersetzt Stabily automatisch durch Platzhalter wie „Person A“.
- Die KI kommt von Mistral AI aus der EU, unsere Server laufen in Frankfurt am Main.
{
"safety": {
"signal": "selbstgefaehrdung",
"must_display": true,
"notice": {
"title": "Wenn jemand in akuter Gefahr ist",
"text": "Lass die betroffene Person nicht allein, hol eine verantwortliche Person dazu und ruf im Notfall sofort an. Die Nummern und Anlaufstellen für dein Land findest du unter „Notfall-Hilfe öffnen“.",
"emergency_number": "112",
"help_label": "Notfall-Hilfe öffnen",
"help_url": "https://stabily.ai/notfall-support"
}
}
}So zeigst du ihn an
Wenn jemand in akuter Gefahr ist
Lass die betroffene Person nicht allein, hol eine verantwortliche Person dazu und ruf im Notfall sofort an.
Für Coding-Agents gemacht
Lass deinen Coding-Agent die Arbeit machen
Die API ist so gebaut, dass KI-Coding-Assistenten sie ohne Umwege verstehen. Kopier den Prompt, ergänz euren Stack, fertig ist der erste Entwurf.
- Klare JSON-StrukturenGleiche Felder überall, sprechende Namen, keine Überraschungen.
- Eindeutige FehlerJeder Fehler hat dieselbe Form, einen Code und sagt, ob sich ein neuer Versuch lohnt.
- OpenAPI und llms.txtEine maschinenlesbare Beschreibung, die dein Coding-Agent direkt versteht (geplant).
Du bist mein Coding-Agent. Binde die Stabily-API in unsere Plattform ein.
Rahmen:
- Basis-URL: https://api.stabily.ai/v1 (REST, JSON, Antworten optional als Server-Sent Events).
- Der API-Schlüssel liegt in der Umgebungsvariable STABILY_API_KEY. Er darf nur auf unserem Server verwendet werden, nie im Browser, nie im Log.
- Als "user" schicken wir unsere interne, nicht sprechende Nutzer-ID der Lehrkraft. Keine E-Mail-Adresse, kein Name.
Aufgaben:
1. Eine Serverroute, die für die angemeldete Lehrkraft POST /v1/sessions aufruft und sie auf die zurückgegebene "url" weiterleitet (Einbettung ohne zweites Login).
2. Eine Serverfunktion askCoach(userId, message), die POST /v1/conversations aufruft und Text, Quellen, Antwort-Optionen und "safety" zurückgibt.
3. Ein UI-Baustein, der die Antwort zeigt. Wenn "safety" nicht null ist, zeige "safety.notice" immer und vollständig an: Titel, Text, Notruf und den Link zur Notfall-Hilfe.
4. Zeige "names_replaced" dezent unter der Nachricht der Lehrkraft an ("Namen ersetzt: Jonas → Person A").
Fehler:
- Jeder Fehler hat die Form { "error": { "type", "code", "message", "request_id", "retryable" } }.
- Wiederhole nur, wenn "retryable" true ist: höchstens dreimal, mit wachsendem Abstand, und halte dich an "Retry-After".
- Logge bei jedem Fehler "request_id" (und "incident_id", falls vorhanden), nie den Inhalt der Nachricht.
Tests:
- Schreibe Tests mit gemockten Antworten im Format der Beispiele auf https://stabily.ai/entwickler, auch für 401, 422, 429 und 500.Ausblick
Was noch kommt
Diese Seite ist eine Vorschau. Wenn du früh dabei sein willst, schreib uns: Die ersten Partner gestalten die API mit.
Developer-Workspace
Eigene Schlüssel anlegen, Nutzung sehen, Team einladen.
Sandbox
Echte Anfragen mit Testdaten, ohne echte Lehrkräfte.
Echter Zugang
Zuerst Coach, Handlungsplan und Einbettung, der Rest folgt.
Preise
Preise und Konditionen besprechen wir persönlich mit dir.
Lust, Stabily einzubauen?
Erzähl uns kurz, was ihr baut. Wir melden uns mit den nächsten Schritten und beantworten deine technischen Fragen.
oder direkt an kiarash@stabilimkopf.com