Zum Inhalt springen

Frisch gestartet: Bis 30. November kann noch etwas haken – gib uns Feedback, wir beheben es schnell!

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.

  1. Schritt 1

    Schlüssel holen

    Du bekommst einen API-Schlüssel für deinen Server. Er bleibt dort und kommt nie in den Browser.

  2. Schritt 2

    Lehrkraft durchreichen

    Dein Server schickt eure interne ID der Lehrkraft mit. Kein Name, keine E-Mail, kein zweites Login.

  3. 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 Anfrage

Drü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.

  1. Fehler erkanntUnser Server merkt sofort, dass etwas nicht stimmt.
  2. Automatisch wiederholtEr versucht es selbst noch einmal, bevor du etwas davon merkst.
  3. ProtokolliertKlappt es nicht, landet der Fehler mit einer Kennung in unserem Protokoll.
  4. Team informiertUnser Team bekommt Bescheid und kümmert sich darum.

So antwortet die API500 Internal Server Error

Retry-After: 30

JSON
{
  "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.
Teil der Antwort
{
  "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).
Prompt für deinen Coding-Agent
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.