2xx weisen auf Erfolg hin. Codes im Bereich 4xx weisen auf ein Problem mit Ihrer Anfrage hin, das Sie beheben können. Codes im Bereich 5xx weisen auf ein serverseitiges Problem hin.
Format der Fehlerantwort
Die meisten synchronen API-Fehler verwenden einen gemeinsamen verschachteltenerror-Umschlag:
errors-Array innerhalb von error. Jeder Eintrag identifiziert das ungültige Feld mit location und raw_location und erläutert den Fehler in message.
Einige Endpunktfamilien verwenden bewusst andere Strukturen:
- Abrechnungsablehnungen (
402, einige403) geben{"code", "message", "resolution_url"}anstelle des verschachtelten Umschlags zurück – siehe 402 und 403 unten. - Aufwärm-Antworten (
425) enthalten einenRetry-After-Header. OpenAI-förmige Bodies enthalten zusätzlichcode: "model_warming"– siehe 425 unten. - Rate-Limit-Antworten (
429) fügen auf oberster Ebene nebendetaildie Feldercodeundscopesowie die HeaderX-RateLimit-ScopeundX-RateLimit-Codehinzu – siehe 429 unten. - Unbehandelte Serverfehler (
500) geben{"error", "message"}anstelle des verschachtelten Umschlags zurück. - Anfragen an
/v1/messagesmit einemanthropic-version-Header erhalten einen Anthropic-förmigen{"type": "error", "error": {"type", "message"}}-Umschlag.
Fehler interaktiver Futures
Ein HTTP-4xx bedeutet, dass der Server den interaktiven Aufruf vor dem Einreihen abgelehnt hat. Eine erfolgreiche Einreihung gibt eine future_id zurück. Fragen Sie bis completed, failed oder cancelled ab. Ein Future kann mit status: "failed" und error.message enden. Behandeln Sie error.category nicht als Wiederholungsregel.
Statuscodes
400 - Ungültige Anfrage
Die Anfrage selbst ist fehlerhaft – ungültiges JSON oder ein Query-/Pfadparameter vom falschen Typ. Inferenz-Endpunkte geben400 auch zurück, wenn eine Eingabe die Schemavalidierung besteht, aber nicht verarbeitet werden kann, etwa ein GLiDE-Prompt, der länger als das Kontextfenster ist, oder ein Bild außerhalb der GLiDE-Bildlimits.
Behebung: Stellen Sie sicher, dass Ihr Anfrage-Body gültiges JSON ist und dass Query-/Pfadparameter den in der Endpunkt-Referenz dokumentierten Typen entsprechen. Lesen Sie bei einer Inferenzeingabe error.message und korrigieren Sie die genannte Eingabe.
GLiDE-Bildfehler
POST /v1/systemone gibt diese 400-Antworten für ein Bild in state zurück. Jede verwendet den verschachtelten Envelope mit "type": "invalid_request_error" und "code": null, werten Sie daher error.message aus:
Ein
image_url-Teil ohne image_url.url scheitert stattdessen an der Schemavalidierung und gibt 422 mit image_url parts require an image_url.url. zurück.
401 - Nicht autorisiert
Ihre Anfrage enthielt keinen gültigen API-Schlüssel, der Schlüssel wurde widerrufen oder Ihr Konto wurde aufgrund einer Abrechnungs- oder Betrugsprüfung gesperrt. Behebung: Vergewissern Sie sich, dass der HeaderX-API-Key vorhanden ist und Ihren aktuellen Schlüssel enthält. Wenn Sie den Schlüssel kürzlich widerrufen haben, erstellen Sie unter Settings → API Keys einen neuen. Ist Ihr Konto gesperrt, wenden Sie sich an support@fastino.ai. Anweisungen zur Einrichtung finden Sie unter Authentifizierung.
402 - Zahlung erforderlich
Ihr Konto verfügt nicht über ausreichende Credits, um die Anfrage abzuschließen. Dascode-Feld im Antwort-Body gibt an, welcher Fall zutrifft – am häufigsten out_of_credits (Ihre enthaltenen Credits sind aufgebraucht und es gibt kein ausgabefähiges bezahltes Guthaben) oder funding_required (Ihr Konto wurde noch nie aufgeladen). spend_limit_reached bedeutet, dass ein tägliches oder monatliches Ausgabenlimit Ihres Teams oder Projekts erreicht wurde, und billing_required bedeutet, dass vor der Inferenz eine Abrechnungsaktion nötig ist.
Behebung: Melden Sie sich unter Fastino an, gehen Sie zu Settings → Billing und laden Sie Ihr Guthaben auf oder upgraden Sie Ihren Tarif. Bei spend_limit_reached erhöhen Sie das Limit in den Abrechnungseinstellungen oder warten, bis der Zeitraum zurückgesetzt wird. Details zu Tarifen und Credits finden Sie unter Pläne & Preise.
403 - Verboten
Ihr Team hat die maximale monatliche Overage-Ausgabe seines Tarifs erreicht (code: "credit_ceiling_reached") oder Ihr Konto benötigt eine verifizierte Zahlungsmethode, bevor Inferenz ausgeführt werden kann (code: "card_required").
Behebung: Bei einer Ablehnung wegen erreichter Ausgabengrenze upgraden Sie Ihren Tarif unter Settings → Billing, um die Obergrenze anzuheben. Bei einer Ablehnung wegen Kartenverifizierung fügen Sie eine gültige Zahlungsmethode hinzu. Beide Antworten enthalten eine resolution_url, die direkt auf die Seite zur Behebung verweist.
404 - Nicht gefunden
Die angeforderte Ressource existiert nicht. Dies kann passieren, wenn ein Datensatzname, eine Trainingsjob-ID, eine Evaluations-ID, eine Projekt-ID oder eine Modell-ID falsch geschrieben oder gelöscht wurde. Behebung: Überprüfen Sie die ID oder den Namen im Anfragepfad oder -body sorgfältig. Verwenden Sie den entsprechendenGET-Listenendpunkt (zum Beispiel GET /v1/training/jobs, GET /v1/base-models), um zu bestätigen, dass die Ressource existiert.
409 - Konflikt
Das Modell existiert im Katalog, kann aber derzeit nicht bedient werden – zum Beispiel ein reines Trainings-Basismodell, das für direkte Inferenz angefordert wurde, oder ein On-Demand-Deployment, dessen Bereitstellung nach Abschluss eines Trainingsjobs noch nicht abgeschlossen ist. Behebung: Prüfen Siesupports_inference und supports_on_demand_inference für das Modell über GET /v1/base-models oder wiederholen Sie den Aufruf, nachdem das Deployment bereitgestellt wurde.
413 - Nutzdaten zu groß
Der Anfrage-Body – typischerweise ein Datei-Upload für eine Evaluation oder einen Datensatz – überschreitet das Größenlimit des Endpunkts. Behebung: Prüfen Sie in der Endpunkt-Referenz das Upload-Größenlimit und teilen oder komprimieren Sie die Nutzdaten, bevor Sie es erneut versuchen.422 - Nicht verarbeitbare Entität
Die Validierung des Anfrage-Bodys ist fehlgeschlagen. Ein erforderliches Feld fehlt, ein Feld hat den falschen Typ oder ein Wert liegt außerhalb des zulässigen Bereichs. Behebung: Prüfen Sieerror.message und die Einträge in error.errors auf das jeweils fehlgeschlagene Feld. Häufige Ursachen sind:
- Weglassen von
modelodertypebeiPOST /v1/training/jobs - Senden von weniger als 1 oder mehr als 1.000 Strings im
inputs-Array bei Endpunkten zum Labeln vorhandener Daten
425 - Zu früh
Das Modell wärmt sich vorübergehend auf und ist noch nicht bereit, Inferenz zu bedienen. Das ist bei der ersten Anfrage nach einer Zeit ohne Traffic oder gegen ein frisch bereitgestelltes On-Demand-Deployment zu erwarten und bedeutet nicht, dass Ihre Anfrage fehlerhaft ist. Die Aufwärmzeit hängt vom Modell ab, daher kann eine Anfrage mehrmals425 zurückgeben, bevor sie erfolgreich ist.
Die meisten Endpunkte geben einen OpenAI-förmigen Body mit code: "model_warming" zurück:
/v1/messages mit einem anthropic-version-Header erhalten stattdessen einen Anthropic-förmigen Body ohne code-Feld:
Behebung: Warten Sie
Retry-After Sekunden (30, falls der Header fehlt) und senden Sie dieselbe Anfrage erneut, mit einer begrenzten Anzahl von Wiederholungen. Jedes Beispiel wiederholt höchstens 5 Mal, setzt ein Client-Timeout von 300 Sekunden und bricht bei jeder anderen Nicht-2xx-Antwort ab. Dieselbe Schleife funktioniert für /v1/systemone; ändern Sie URL und Request-Body.
429 - Zu viele Anfragen
Sie haben ein Anfrage-Rate-Limit für diesen Endpunkt überschritten. Die Antwort enthält einenRetry-After-Header sowie die Header X-RateLimit-Scope und X-RateLimit-Code, die angeben, welches Limit Sie erreicht haben – der JSON-Body führt neben detail die passenden Felder code und scope.
Behebung: Beachten Sie den Retry-After-Wert und warten Sie, bevor Sie es erneut versuchen. Ein Retry-Muster finden Sie unter Wiederholungen und Modell-Warm-up. Beachten Sie, dass Credit- und Overage-Ablehnungen 402/403 zurückgeben, nicht 429.
451 - Aus rechtlichen Gründen nicht verfügbar
Das angeforderte Modell ist für Ihr Konto aufgrund von Exportkontrollen oder Sanktionsbeschränkungen in Ihrer Region nicht verfügbar. Behebung: Wenn Sie glauben, dass Ihr Zugriff fälschlicherweise eingeschränkt wurde, wenden Sie sich an den Support.500 - Interner Serverfehler
Auf den Servern von Fastino ist ein unerwarteter Fehler aufgetreten. Dieser wird nicht durch Ihre Anfrage verursacht. Der Body verwendet die Feldererror und message anstelle von detail:
503 - Dienst nicht verfügbar
Eine für die Anfrage benötigte Abhängigkeit – die Abrechnungsprüfung oder ein Status-/Metrik-Endpunkt eines Anbieters – ist vorübergehend nicht verfügbar. Behebung: Warten Sie einen Moment und versuchen Sie es erneut. Wenn der Fehler weiterhin auftritt, prüfen Sie unter status.fastino.ai den aktuellen Servicestatus oder wenden Sie sich an den Support.529 - Überlastet (nur Anthropic-kompatibler Endpunkt)
POST /v1/messages spiegelt Anthropics eigene overloaded_error-Antwort wider, wenn die vorgelagerte Claude-Kapazität vorübergehend ausgelastet ist.
Behebung: Wiederholen Sie mit Backoff, genauso wie Sie es bei einem 429 oder 503 tun würden.
