FRAG SOFIA

Konto

ÖFFENTLICHE API

Sofia in deine App, dein Tool oder dein Unternehmen integrieren.

Gleiche Sofia-Logik, gleicher Kontextkern. Nur der Zugriff ist anders: statt Browser-Session über API-Key.

1. Schlüssel erzeugen

Im Konto kannst du API-Keys erzeugen und bei Bedarf jederzeit widerrufen.

2. Mit Bearer senden

Nutze `Authorization: Bearer <api_key>` in jedem Request.

3. Verlauf fortsetzen

Wenn du `thread_id` weiterverwendest, bleibt Sofia im gleichen Gesprächsstrang.

ENDPUNKTE

Was du heute direkt nutzen kannst

POST/api/v1/api-keys
POST/api/v1/chat
GET/api/v1/chat-history
GET/api/v1/server-info
GET/v1/models
POST/v1/responses

SCHNELLSTART

Minimaler Request

curl -X POST "/v1/responses" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sofia",
    "input": [
      { "role": "user", "content": "Erstelle mir eine kurze Zusammenfassung." }
    ]
  }'

SICHERHEIT

Scopes und Rückgabecodes klar halten

Scopes (MVP)

  • chat:write Nachrichten senden
  • chat:read Verlauf lesen
  • projects:write Projektkontext mitsenden
  • /v1/responses nutzt dieselbe premium-geschützte Sofia-API

Antwortcodes

  • 200 erfolgreich
  • 403 Scope fehlt
  • 429 Tageslimit erreicht