Hilfe & Fehlerbehebung

Kontakt

Bei Problemen mit maKI wenden Sie sich an:
Philipp Hematty — philipp.hematty@uni-mannheim.de

Supportzeiten: Mo–Fr, 09:00–17:00 (Best Effort, keine garantierte Antwortzeit).

Eskalation: Alexander Pfister (Abteilungsleitung).

Häufige Fehler

401 Unauthorized

{ "error": { "message": "Invalid API key", "code": 401 } }

• Prüfen Sie, ob der API-Schlüssel korrekt im Authorization-Header steht: Bearer sk-...
• Schlüssel abgelaufen oder widerrufen? Wenden Sie sich an den Support für einen neuen Schlüssel.

404 Model not found

{ "error": { "message": "Model not found", "code": 404 } }

• Prüfen Sie den Modellnamen — verfügbare Modelle finden Sie unter Verfügbare Modelle.
• Modellnamen sind case-sensitive.

429 Rate Limit

{ "error": { "message": "Rate limit exceeded", "code": 429 } }

• Ihr Schlüssel hat das Anfragelimit erreicht. Warten Sie kurz und versuchen Sie es erneut.
• Limits pro Schlüssel finden Sie unter API-Schlüssel.

503 Service Unavailable

• Der Dienst ist vorübergehend nicht erreichbar (z.B. Wartung oder GPU-Neustart).
• Versuchen Sie es in wenigen Minuten erneut.
• Bei anhaltendem Ausfall: Support kontaktieren.

Timeout / langsame Antworten

• Große Modelle und lange Prompts benötigen mehr Rechenzeit.
• Nutzen Sie stream: true für schrittweise Ausgabe.
• Reduzieren Sie max_tokens wenn möglich.

Dienststatus prüfen

Der Health-Endpunkt zeigt, ob der Dienst erreichbar ist:

curl https://maki.uni-mannheim.de/health

Wartungsankündigungen

Geplante Wartungsarbeiten werden mindestens 3 Werktage im Voraus per E-Mail an alle API-Schlüssel-Inhaber angekündigt.