Fehlercodes

Statuscodes, Fehlertypen und was jeweils hilft.

Fehler kommen immer als JSON in derselben Form. code ist für dein Programm gedacht, message für Menschen, request_id für uns, wenn du uns wegen eines Fehlers schreibst.

Fehler

{
  "error": {
    "code": "rate_limited",
    "message": "Zu viele Anfragen in diesem Zeitfenster.",
    "retry_after": 12,
    "request_id": "req_6f1c0b9e2a7d43f58e0a19c4"
  }
}

Status	code	Was passiert ist	Was hilft
400	`invalid_request`	Die Anfrage ist unvollständig, falsch aufgebaut oder hat ein unbekanntes Feld	Die Meldung lesen und die Anfrage korrigieren, nicht wiederholen
401	`unauthorized`	Schlüssel fehlt, falsch oder widerrufen	Schlüssel prüfen, in der Konsole einen neuen anlegen
403	`forbidden`	Modell oder Endpunkt ist für den Schlüssel nicht freigegeben, FTI-3 Hoch ohne Flixi Plus	Eine Kennung aus Modelle verwenden
404	`not_found`	Diesen Endpunkt gibt es nicht	Pfad prüfen, alle Endpunkte beginnen mit `/v1`
413	`invalid_request`	Datei oder Anfrage zu groß	Audio unter 25 MB, Anfragen unter 32 MB halten
429	`rate_limited`	Zu viele Anfragen oder Tokens in einer Minute	So viele Sekunden warten, wie `Retry-After` sagt, dann wiederholen
429	`quota_exceeded`	Das freie Monatskontingent des Schlüssels ist aufgebraucht	Bis zum Monatsanfang warten, `reset` nennt das Datum
500	`server_error`	Ein Fehler bei uns	Nach kurzer Pause wiederholen
503	`unavailable`	Die API ist gerade nicht erreichbar	Nach einer Minute wiederholen

Jede Antwort trägt die Kopfzeile X-Request-Id, im Fehlerfall steht derselbe Wert in request_id.

Wiederholen, aber richtig

Wiederhole nur bei rate_limited, 500 und 503. Ein quota_exceeded löst sich erst am Monatsanfang, 400 bis 404 gar nicht von selbst.

curl -i https://api.flixtake.app/v1/responses \
  -H "Authorization: Bearer $FLIXTAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "fti-3-sofort", "input": "Hallo", "max_output_tokens": 64}'