Einführung

Willkommen im meinGPT Entwicklerhandbuch. Mit der meinGPT API kannst Du sicher und einfach eigene Anwendungen mit KI bauen, ohne dass Du zusätzliche Accounts und Services benötigst. Außerdem stehen viele der leistungsstarken Features aus der Plattform wie Assistenten und Workflows auch in der API zur Verfügung.

API-Übersicht

Die meinGPT API bietet programmatischen Zugriff auf:

• LLM-Antworten und Embeddings
• Assistenten
• Ausführung von Workflows
• Audio-Transkription

Schnellstart

curl -X POST "https://app.meingpt.com/api/openai/v1/chat/completions" \
-H "Authorization: Bearer $MEINGPT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "messages": [
    {"role": "user", "content": "Hallo, meinGPT!"}
  ],
  "model": "gpt-4o-mini"
}'

Rate Limits

Für die meinGPT API gilt kein Limit für die Anzahl gleichzeitiger (paralleler) Streaming-Requests. Stattdessen wird ein Tokenbudget pro Minute geprüft, das mehrere Ebenen gleichzeitig berücksichtigt:

• Pro Nutzer: Standardmäßig 125.000 Tokens/Minute
• Pro Organisation: Standardmäßig 250.000 Tokens/Minute (wird von allen Nutzern der Organisation gemeinsam genutzt)

Alle Limits laufen über ein gleitendes 60-Sekunden-Fenster und zählen Input- und Output-Tokens zusammen. Ein individuell höheres Limit für eine Organisation kann aktuell nicht selbstständig konfiguriert werden — meldet euch bei uns, um eine Anpassung zu besprechen.

Requests oberhalb des Limits werden nicht in eine Warteschlange gestellt, sondern sofort mit einem 429-Fehler abgelehnt. Die Antwort enthält einen Retry-After-Header (aktuell ein fester Wert von 60 Sekunden) sowie Header mit Informationen zu Limit, verbleibendem Budget und Reset-Zeitpunkt für das Tokenbudget.

Fehlerbehandlung

Wenn eine Anfrage nicht bearbeitet werden kann, liefert die API einen HTTP-Statuscode ungleich 2xx zurück. Gängige Codes:

• 400 – Ungültige Anfrage (z. B. nicht unterstützter Parameterwert, fehlerhafte Eingabe)
• 401 – Ungültiger oder fehlender API-Schlüssel
• 403 – Modell oder Completions-API nicht für die Organisation freigeschaltet
• 429 – Rate-Limit erreicht (siehe Rate Limits oben) – mit Backoff erneut versuchen oder zu einem anderen Modell wechseln
• 500 – Vorübergehender Fehler beim KI-Anbieter – nach kurzer Wartezeit erneut versuchen

Manche Fehlerantworten enthalten möglicherweise keinen JSON-Body, den OpenAI-SDK-basierte Tools auslesen können (einige Drittanbieter-Clients zeigen das als „no body" an). Prüfe deshalb immer zuerst den HTTP-Statuscode statt Dich auf den Response-Body zu verlassen, und implementiere Retries mit exponentiellem Backoff für 429- und 500-Antworten.

Support

Wenn du Hilfe mit der API benötigst, kontaktiere uns unter support@meingpt.com oder stelle eine Anfrage über unser Support-Portal↗.

Best Practices

• Behandle Fehler immer ordnungsgemäß
• Implementiere exponentielles Backoff für Wiederholungen
• Cache Antworten wenn angemessen
• Überwache Deine Nutzung, um Limits zu vermeiden