Zum Hauptinhalt springen
Die Fastino API verwendet standardmäßige HTTP-Statuscodes, um das Ergebnis jeder Anfrage zu kommunizieren. Codes im Bereich 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 verschachtelten error-Umschlag:
Validierungsfehler verwenden denselben Umschlag und ergänzen ein 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, einige 403) geben {"code", "message", "resolution_url"} anstelle des verschachtelten Umschlags zurück – siehe 402 und 403 unten.
  • Aufwärm-Antworten (425) enthalten einen Retry-After-Header. OpenAI-förmige Bodies enthalten zusätzlich code: "model_warming" – siehe 425 unten.
  • Rate-Limit-Antworten (429) fügen auf oberster Ebene neben detail die Felder code und scope sowie die Header X-RateLimit-Scope und X-RateLimit-Code hinzu – siehe 429 unten.
  • Unbehandelte Serverfehler (500) geben {"error", "message"} anstelle des verschachtelten Umschlags zurück.
  • Anfragen an /v1/messages mit einem anthropic-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 geben 400 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 Header X-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

Eine 402-Antwort bedeutet, dass Ihrem Konto keine ausgabefähigen Credits mehr zur Verfügung stehen oder eine Abrechnungsaktion erforderlich ist, bevor Inferenz ausgeführt werden kann. Alle API-Aufrufe schlagen fehl, bis Sie Credits hinzufügen oder Ihren Tarif upgraden. Besuchen Sie Settings → Billing oder siehe Pläne & Preise, um dies zu beheben.
Ihr Konto verfügt nicht über ausreichende Credits, um die Anfrage abzuschließen. Das code-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 entsprechenden GET-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 Sie supports_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 Sie error.message und die Einträge in error.errors auf das jeweils fehlgeschlagene Feld. Häufige Ursachen sind:
  • Weglassen von model oder type bei POST /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 mehrmals 425 zurückgeben, bevor sie erfolgreich ist. Die meisten Endpunkte geben einen OpenAI-förmigen Body mit code: "model_warming" zurück:
Anfragen an /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.
Mit einem SDK finden Sie unter Wiederholungen und Modell-Warm-up, welche Antworten Sie wiederholen sollten und wie Sie Backoff anwenden.

429 - Zu viele Anfragen

Sie haben ein Anfrage-Rate-Limit für diesen Endpunkt überschritten. Die Antwort enthält einen Retry-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 Felder error und message anstelle von detail:
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.

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.