API Dokumentation

Übersicht

Die SHIVA AI API ermöglicht dir, KI-gestützte Konversationen in deine Anwendungen zu integrieren. Die API basiert auf REST und verwendet JSON für Anfragen und Antworten.

Authentifizierung

Für geschützte Endpoints wird ein Bearer Token benötigt, den du nach der Anmeldung erhältst.

Login

{
  "email": "user@example.com",
  "password": "your-password"
}

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1...",
  "user": {
    "id": 1,
    "email": "user@example.com",
    "tier": "free"
  }
}

Registrierung

{
  "email": "user@example.com",
  "password": "min-8-characters"
}

Chat Endpoint (Streaming)

Für Echtzeit-Streaming von AI-Antworten.

{
  "messages": [
    { "role": "user", "content": "Hallo, wie geht es dir?" }
  ],
  "model": "default"
}

Tipp: Verwende "model": "pro" für Llama 70B (nur Pro-Tarif)

Die Antwort wird als Server-Sent Events (SSE) gestreamt:

data: {"response": "Hallo"}
data: {"response": "! Mir"}
data: {"response": " geht es"}
data: {"response": " gut."}
data: [DONE]

Simple Chat (Nicht-Streaming)

Für einfache Anfragen ohne Streaming.

{
  "message": "Was ist die Hauptstadt der Schweiz?",
  "chatId": 123
}

chatId ist optional - wenn angegeben, wird die Nachricht in der Chat-Historie gespeichert

{
  "response": "Die Hauptstadt der Schweiz ist Bern...",
  "model": "mistral-7b"
}

Chat Historie

Verwalte gespeicherte Chats. Alle Endpoints erfordern Authentifizierung.

Chats auflisten

Chat erstellen

Chat laden

Chat löschen

Nachricht speichern

{
  "role": "user",
  "content": "Die Nachricht..."
}

role kann "user" oder "assistant" sein

Fehlerbehandlung

Die API verwendet Standard HTTP Status Codes:

{
  "error": "Beschreibung des Fehlers"
}

Rate Limits