Fehler

Fehler treten an zwei verschiedenen Stellen auf, mit zwei verschiedenen Vokabularen:

API-Anfragefehler — die HTTP-Antwort auf einen synchronen API-Aufruf (Authentifizierung, Abrechnung, fehlerhafte Anfragen, nicht vorhandene Ressourcen). Siehe API-Anfragefehler.
Fehlercodes für fehlgeschlagene Predictions — die Anfrage wurde angenommen und in die Warteschlange gestellt, aber die Prediction selbst endete mit status: "failed". Der Fehler wird durch das error-Objekt der Prediction beschrieben, das Sie über die Prediction-Status-Endpunkte, über Webhook-Zustellungen und über den Result-Endpunkt erhalten. Siehe Fehlercodes für fehlgeschlagene Predictions.

Fehlercodes für fehlgeschlagene Predictions

Eine fehlgeschlagene Prediction trägt ein error-Objekt:

{
  "status": "failed",
  "error": {
    "code": "internal_server_error",
    "reason": "provider_account_error",
    "retryable": false,
    "message": "This model is temporarily unavailable due to an upstream account issue on our side. Retrying will not help; we have been alerted."
  }
}

Feld	Typ	Beschreibung
`code`	string	Grobe Einordnung: im Wesentlichen, in wessen Verantwortungsbereich das Problem liegt. Immer vorhanden. Offene Menge — siehe Unbekannte Werte.
`reason`	string, optional	Feingranulare, maschinenlesbare Ursache. Offene Menge. Fehlt, wenn der Fehler keiner bestimmten Ursache zugeordnet wurde; das Fehlen ist für sich genommen kein Signal.
`retryable`	boolean, optional	Ob ein erneuter Versuch mit derselben, unveränderten Eingabe erfolgreich sein kann. Wenn vorhanden, ist dieser Wert maßgeblich und hat Vorrang vor jedem Standardwert je `code`.
`message`	string	Menschenlesbare Erläuterung für Logs und Endnutzer. Die Formulierung ändert sich ohne Ankündigung — parsen Sie sie niemals und gleichen Sie keine Textmuster darauf ab.
`timestamp`	string, optional	ISO 8601-Zeitpunkt, zu dem die Prediction fehlgeschlagen ist — nicht der Zeitpunkt der Antwort, die ihn transportiert. Fehlt bei einem Fehler, für den kein Endzeitpunkt erfasst wurde.

Fehlgeschlagene Predictions werden nicht berechnet; das für die Anfrage reservierte Guthaben wird wieder freigegeben. Eine Prediction, die nicht fehlgeschlagen ist, trägt error: null. Siehe Hinweis zur Migration, wenn Sie vor dem 17. August 2026 integriert haben.

Wo der Fehler bei Ihnen ankommt

Dasselbe error-Objekt wird auf jedem Kanal veröffentlicht; Sie können es also dort lesen, wo Sie ohnehin hinschauen:

Kanal	Wo das Objekt steht
`GET /v1/queue/requests/{request_id}/status` und `/status/stream`	`error`, neben `success: false`
`GET /v1/queue/requests/{request_id}` (der Result-Endpunkt)	`error.details` einer `400` — siehe unten
`GET /v1/predictions/{prediction_id}`	`error`
Webhook-Zustellung	`error` der `failed`-Payload

Einen Fehler über den Result-Endpunkt lesen

Wer die Ausgabe einer fehlgeschlagenen Prediction abruft, erhält eine 400 mit genau dem Fehler, der dazu geführt hat, unter dem Code auf Anfrageebene PREDICTION_FAILED:

{
  "error": {
    "type": "invalid_request_error",
    "code": "PREDICTION_FAILED",
    "message": "The prediction may contain sensitive or restricted content and has been suppressed. Please revise your input.",
    "details": {
      "code": "unsafe_content",
      "message": "The prediction may contain sensitive or restricted content and has been suppressed. Please revise your input.",
      "reason": "moderation_blocked",
      "retryable": false,
      "timestamp": "2026-08-14T17:51:47.206Z"
    }
  },
  "request_id": "req_01JXQ2ZK8W3P5N7V0T6Y4M9DQR",
  "timestamp": "2026-08-17T09:00:00.000Z",
  "path": "/v1/queue/requests/pd_a839exsaLNmVZzWvDaxAuapS"
}

Zwei Codes auf zwei Ebenen — und sie gehören nicht zum selben Vokabular:

error.code ist PREDICTION_FAILED, ein API-Anfragefehler mit der Bedeutung „die Prediction, deren Ausgabe Sie angefordert haben, hat keine erzeugt“;
error.details ist das error-Objekt der Prediction selbst — identisch mit dem, was /status für dieselbe Anfrage meldet, sodass die beiden Endpunkte sich über die Fehlerursache niemals widersprechen können. Verzweigen Sie über error.details.reason und error.details.retryable.

error.message wiederholt die Meldung der Prediction, sodass auch ein Client, der nur die Meldung der obersten Ebene liest, etwas Brauchbares erhält. Zwei Timestamps, zwei Bedeutungen. Der timestamp der obersten Ebene gibt an, wann diese HTTP-Antwort erzeugt wurde; error.details.timestamp gibt an, wann die Prediction fehlgeschlagen ist. Bei einer Prediction, die Sie Tage später abrufen, liegen beide Tage auseinander. Lesen Sie immer den inneren Wert, wenn Sie den Fehler meinen. Die offiziellen Client-Bibliotheken packen das für Sie aus: result() wirft einen Fehler, dessen code, reason und retryable die der Prediction selbst sind — identisch mit dem, was subscribe() für denselben Fehler wirft. Eine Prediction, die noch in der Warteschlange steht oder noch läuft, sowie eine abgebrochene Prediction geben weiterhin dieselbe generische 400 zurück wie bisher.

Entscheiden, ob ein erneuter Versuch sinnvoll ist

Lesen Sie retryable. Es beantwortet genau eine Frage — führt dieselbe Anfrage, erneut gesendet, zu einem anderen Ergebnis? — und ist unabhängig von code: derselbe code kann bei einem Fehler wiederholbar sein und bei einem anderen nicht. retryable ist optional. Fehlt es, greifen Sie auf den Standardwert je code aus der folgenden Tabelle zurück. Genau so hat sich Sunra verhalten, bevor es dieses Feld gab; der Rückgriff ist also immer sicher, nur weniger präzise.

`code`

Code	Standard, wenn `retryable` fehlt	Bedeutung
`invalid_input`	Nein — korrigieren Sie zuerst die Eingabe	Die Eingabe wurde abgelehnt, entweder durch die Schema-Validierung oder durch den Modell-Provider (z. B. Text über einer Längenbegrenzung, ein Bild, das nicht dekodiert werden kann, eine ungültige Parameterkombination), oder eine Eingabedatei konnte nicht abgerufen werden. `message` nennt das konkrete Problem.
`unsafe_content`	Nein — überarbeiten Sie zuerst den Inhalt	Der Prompt oder die Eingabemedien wurden vom Sicherheitssystem des Modell-Providers blockiert, oder die erzeugte Ausgabe wurde von ihm unterdrückt. Derselbe Inhalt wird bei einem erneuten Versuch wieder blockiert; ändern Sie stattdessen den Prompt oder die Medien.
`service_provider_error`	Ja — möglicherweise vorübergehend	Der vorgelagerte Modell-Provider konnte die Anfrage nicht bedienen (Provider-Ausfall, Rate-Limiting). Ein späterer Versuch oder ein anderes Modell kann erfolgreich sein.
`internal_server_error`	Ja	Ein Fehler auf Sunras Seite. Manche davon sind vorübergehend und einen erneuten Versuch wert; andere (ein falsch konfigurierter Endpunkt, ein Problem mit unserem eigenen vorgelagerten Konto) nicht — diese tragen `retryable: false`.
`task_timeout`	Ja	Die Prediction wurde nicht innerhalb der zulässigen Zeit fertig. Ein erneuter Versuch kann gelingen, besonders bei geringerer Last.

`reason`

reason benennt die konkrete Ursache hinter code. Verwenden Sie es für Metriken, Routing und Support-Diagnose; für die Entscheidung über einen erneuten Versuch verwenden Sie retryable. Jede heute veröffentlichte Reason hat unten ihren eigenen Abschnitt, und ihr Anker ist die Reason selbst — #input_fetch_failed, #moderation_blocked und so weiter —, sodass ein Fehlerbericht direkt auf ihre Bedeutung verlinken kann.

Reason	`code`	`retryable`
`input_validation_failed`	`invalid_input`	`false`
`provider_rejected_input`	`invalid_input`	`false`
`input_fetch_failed`	`invalid_input`	`false` oder `true`
`moderation_blocked`	`unsafe_content`	`false`
`provider_rate_limited`	`service_provider_error`	`true`
`provider_unavailable`	`service_provider_error`	`true`
`provider_timeout`	`task_timeout`	`true`
`provider_account_error`	`internal_server_error`	`false`
`endpoint_misconfigured`	`internal_server_error`	`false`
`queue_enqueue_failed`	`internal_server_error`	`true`
`reaped_stalled`	`internal_server_error`	`true`

`input_validation_failed`

code: invalid_input · retryable: false Die Anfrage hat Sunras eigene Schema- oder Parametervalidierung nicht bestanden. message nennt das betroffene Feld. Was zu tun ist: Korrigieren Sie das genannte Feld. Dieselbe Anfrage wird weiterhin fehlschlagen.

`provider_rejected_input`

code: invalid_input · retryable: false Der Modell-Provider hat einen oder mehrere Eingabeparameter abgelehnt. Wenn der Provider uns mitteilt, welche, gibt message das wieder; manche Provider melden nur, dass die Eingabe unzulässig war — dann sagen wir genau das, statt zu raten. Was zu tun ist: Prüfen Sie Ihre Parameter gegen das Schema des Modells — ein Wert außerhalb des zulässigen Bereichs, eine nicht unterstützte Kombination, ein Seitenverhältnis oder eine Dauer, die das Modell nicht akzeptiert.

`input_fetch_failed`

code: invalid_input · retryable: false oder true Eine per URL referenzierte Eingabedatei konnte nicht abgerufen werden. Dies ist die einzige Reason, bei der retryable tatsächlich variiert — lesen Sie also das Feld, statt es anzunehmen:

false — der Host hat uns abgewiesen: eine 4xx, eine Adresse, von der wir nicht abrufen dürfen, ein Redirect oder eine Datei über der Größenbegrenzung;
true — der Host war kurzzeitig nicht erreichbar: eine 5xx, ein Timeout oder ein DNS-Fehler.

message gibt die von Ihnen übermittelte URL wieder, damit Sie erkennen, welche Eingabe fehlgeschlagen ist — ohne deren Query-String, sodass in einer Presigned URL enthaltene Zugangsdaten niemals an Sie zurückgespiegelt werden:

{
  "code": "invalid_input",
  "reason": "input_fetch_failed",
  "retryable": false,
  "message": "Failed to fetch the input file at https://media.example.com/uploads/reference.png: HTTP 403."
}

Was zu tun ist: Ist retryable gleich false, prüfen Sie, ob die URL öffentlich erreichbar ist und ob ein Presigned Link nicht abgelaufen ist. Ist es true, versuchen Sie es erneut.

`moderation_blocked`

code: unsafe_content · retryable: false Vom Content-Safety-System des Modell-Providers blockiert — entweder der eingehende Prompt und die Eingabemedien oder die erzeugte Ausgabe. Was zu tun ist: Ändern Sie den Prompt oder die Medien. Derselbe Inhalt wird beim erneuten Senden wieder blockiert.

`provider_rate_limited`

code: service_provider_error · retryable: true Der Modell-Provider drosselt Anfragen. Was zu tun ist: Versuchen Sie es mit Backoff erneut oder leiten Sie auf ein anderes Modell um.

`provider_unavailable`

code: service_provider_error · retryable: true Der Modell-Provider konnte die Anfrage nicht bedienen. Was zu tun ist: Versuchen Sie es später erneut oder leiten Sie auf ein anderes Modell um.

`provider_timeout`

code: task_timeout · retryable: true Die Prediction wurde nicht innerhalb der zulässigen Zeit fertig. Was zu tun ist: Versuchen Sie es erneut — eine Phase geringerer Last oder eine kleinere Anfrage (kürzere Dauer, niedrigere Auflösung) verbessert die Chancen.

`provider_account_error`

code: internal_server_error · retryable: false Unser eigenes Konto beim Modell-Provider hat ein Problem — Abrechnung, Zugangsdaten oder ein dauerhaftes Kontingent. Das liegt an uns, nicht an Ihrer Eingabe. Was zu tun ist: auf Ihrer Seite nichts; ein erneuter Versuch hilft nicht, und wir werden automatisch alarmiert. Leiten Sie auf ein anderes Modell um, wenn Sie die Kapazität sofort brauchen.

`endpoint_misconfigured`

code: internal_server_error · retryable: false Dieser Modell-Endpunkt ist auf unserer Seite falsch konfiguriert. Was zu tun ist: auf Ihrer Seite nichts; ein erneuter Versuch hilft nicht, und wir werden automatisch alarmiert. Wenden Sie sich bei Dringlichkeit mit der request_id an den Support.

`queue_enqueue_failed`

code: internal_server_error · retryable: true Die Prediction konnte nicht in die Warteschlange gestellt werden. Was zu tun ist: Senden Sie die Anfrage erneut.

`reaped_stalled`

code: internal_server_error · retryable: true Die Prediction blieb hängen und wurde beendet. Was zu tun ist: Senden Sie die Anfrage erneut.

Unbekannte Werte

Sowohl code als auch reason sind offene Mengen. Neue Werte kommen hinzu, sobald wir weitere Fehler einordnen — ohne Ankündigung eines Breaking Change. Ihre Integration darf nicht abstürzen, den Fehler nicht verwerfen und die Payload nicht zurückweisen, wenn sie einen ihr unbekannten Wert sieht.

Unbekannter reason — behandeln Sie ihn, als wäre reason nicht vorhanden, und entscheiden Sie anhand von retryable (oder dem Standardwert je code). Behalten Sie den Rohwert in Ihren Logs; das ist für den Support der schnellste Weg, den Fehler zu identifizieren.
Unbekannter code — behandeln Sie ihn als internal_server_error. Ein Sentinel-Wert lohnt sich namentlich zu kennen: unknown_error_code. Sunra sendet ihn, wenn eine Prediction fehlgeschlagen ist, sich dafür aber keine Einordnung ermitteln ließ.

Hinweis zur Migration: `error` ist `null`, wenn kein Fehler vorliegt

Gültig ab 17. August 2026. Das error-Objekt hat auf jedem Kanal genau eine Darstellung. Drei Unterschiede zwischen ihnen sind entfallen:

error ist null, wenn die Prediction nicht fehlgeschlagen ist. GET /v1/predictions/{prediction_id} antwortete früher bei jeder erfolgreichen, in der Warteschlange stehenden und abgebrochenen Prediction mit einem leeren Objekt — "error": {}. Jetzt antwortet der Endpunkt mit "error": null, so wie es der Warteschlangen-Status-Endpunkt bereits tat. Wenn Sie auf Leerheit prüfen (Object.keys(response.error).length === 0), ersetzen Sie das durch eine Null-Prüfung (response.error === null).
Ein Fehlschlag trägt immer einen nicht leeren code und eine nicht leere message. Wo ein Fehlschlag etwas erfasst hat, das wir nicht einordnen können, erhalten Sie jetzt den Sentinel-Wert unknown_error_code und eine generische Meldung statt eines Feldes, das fehlt, leer oder keine Zeichenkette ist.
Als reiner Text erfasste Fehler erreichen Sie als Text. Eine Handvoll Predictions aus dem April 2026 hat ihren Fehler als bloße Zeichenkette gespeichert. GET /v1/predictions/{prediction_id} verwarf ihn früher, und der Warteschlangen-Status-Endpunkt ersetzte ihn durch die Sentinel-Meldung; beide veröffentlichen ihn jetzt als message unter code: "unknown_error_code".

Es wurde nichts entfernt und es kam kein neues Feld hinzu: error war bereits in jeder dieser Antworten enthalten, und nur sein Wert hat sich geändert. Webhook-Zustellungen bleiben unberührt — sie hatten bereits die Form, auf die die anderen Kanäle zusammengelaufen sind — und error fehlt bei einer succeeded-Zustellung weiterhin, statt als null gesendet zu werden. Kompatibilitätsfenster. Es gibt keine Phase mit doppelter Ausgabe; die API hat an diesem Datum aufgehört, "error": {} zu erzeugen. Wenn Sie Payloads erneut abspielen oder verarbeiten, die Sie davor erfasst haben, behandeln Sie null und {} als dasselbe, bis diese gespeicherten Daten abgelaufen sind.

Bevorstehende Änderung: Einige Fehler erhalten einen spezifischeren `code`

Heute wird ein großer Teil der Fehler als service_provider_error gemeldet, darunter viele, die weder vorübergehend noch vom Provider verschuldet sind. Während wir die Provider nacheinander einordnen, wandern diese Fehler zu dem code, der sie tatsächlich beschreibt:

Ein Provider, der Ihre Eingabe deterministisch ablehnt, wird zu invalid_input (zuvor service_provider_error);
ein Problem auf Sunras Seite, etwa ein falsch konfigurierter Endpunkt oder unser eigenes Provider-Konto, wird zu internal_server_error (zuvor service_provider_error);
eine Eingabedatei, die wir nicht abrufen konnten, wird zu invalid_input (zuvor internal_server_error).

Kein Code wird umbenannt oder entfernt, und es wird kein neuer code-Wert eingeführt — die fünf Werte oben bleiben die vollständige Menge der eingeordneten Codes. Was sich ändert, ist, welchen davon ein bestimmter Fehler erhält, und das geschieht schrittweise, Provider für Provider. Wenn Sie anhand von code verzweigen, ist jetzt ein guter Zeitpunkt, diese Logik auf retryable und reason umzustellen: Beide beschreiben den Fehler direkt und sind von der Neueinordnung nicht betroffen.

API-Anfragefehler

Fehlertyp	Fehlercode	HTTP-Status	Beschreibung
authentication_error	`INVALID_CREDENTIALS`	401	Der angegebene Benutzername oder das Passwort ist falsch
authentication_error	`TOKEN_EXPIRED`	401	Das Authentifizierungstoken ist abgelaufen und muss erneuert werden
authorization_error	`ACCOUNT_NOT_ACTIVE`	403	Das Benutzerkonto ist inaktiv oder gesperrt
authorization_error	`API_KEY_INACTIVE`	403	Der API-Schlüssel ist deaktiviert oder gesperrt
authorization_error	`FROZEN_CREDIT_OPERATION_NOT_ALLOWED`	403	Operationen mit eingefrorenen Guthaben sind in diesem Zustand nicht zulässig
authorization_error	`INSUFFICIENT_PERMISSION`	403	Dem Benutzer fehlen die erforderlichen Berechtigungen für diese Operation
authorization_error	`MODEL_ACCESS_DENIED`	403	Der Zugriff auf das angeforderte Modell ist für diesen Benutzer nicht gestattet
authorization_error	`PREDICTION_ACCESS_DENIED`	403	Der Zugriff auf die angeforderte Vorhersage ist für diesen Benutzer nicht gestattet
authorization_error	`PRICING_OPERATION_NOT_ALLOWED`	403	Die Preisgestaltungsoperation ist im aktuellen Kontext nicht zulässig
client_error	`PAYMENT_PROCESSING_ERROR`	402	Die Zahlung konnte aufgrund von Problemen mit der Zahlungsmethode nicht verarbeitet werden
client_error	`PREDICTION_CREDITS_ERROR`	402	Unzureichendes Guthaben, um für die Vorhersageanforderung zu reservieren
conflict_error	`CREDIT_PACKAGE_UNAVAILABLE`	409	Das Guthabenpaket ist nicht zum Kauf verfügbar
conflict_error	`DUPLICATE_API_KEY_NAME`	409	Ein API-Schlüssel mit diesem Namen existiert bereits in der Organisation
conflict_error	`DUPLICATE_INVITATION`	409	Eine aktive Einladung für diesen Benutzer existiert bereits
conflict_error	`INVALID_FROZEN_CREDIT_STATUS`	409	Das eingefrorene Guthaben befindet sich nicht im erwarteten Zustand für diese Operation
conflict_error	`INVALID_PAYMENT_STATUS`	409	Die Zahlung befindet sich nicht im korrekten Zustand für diese Operation
conflict_error	`INVALID_SUBSCRIPTION_STATUS_TRANSITION`	409	Das Abonnement kann nicht vom aktuellen in den angeforderten Zustand geändert werden
conflict_error	`MODEL_ENDPOINT_ALREADY_EXISTS`	409	Ein Modellendpunkt mit dieser Konfiguration existiert bereits
conflict_error	`PAYMENT_ALREADY_PROCESSED`	409	Die Zahlung wurde bereits verarbeitet und kann nicht geändert werden
conflict_error	`PREDICTION_CANNOT_BE_CANCELED`	409	Die Vorhersage befindet sich in einem Zustand, der nicht abgebrochen werden kann
conflict_error	`PREDICTION_INVALID_STATUS`	409	Die Vorhersage befindet sich nicht im erwarteten Zustand für diese Operation
conflict_error	`PREDICTION_STALLED`	409	Die Vorhersage ist zu lange ins Stocken geraten und erfordert Aufmerksamkeit
conflict_error	`QUEUE_ITEM_CANNOT_BE_CANCELED`	409	Die in der Warteschlange befindliche Vorhersage kann in ihrem aktuellen Zustand nicht abgebrochen werden
conflict_error	`SERVICE_PROVIDER_ALREADY_EXISTS`	409	Ein Dienstanbieter mit diesem Namen existiert bereits
conflict_error	`TRANSACTION_ALREADY_VOIDED`	409	Die Transaktion wurde bereits storniert
conflict_error	`TRANSACTION_NOT_VOIDED`	409	Die Transaktion befindet sich nicht in einem stornierten Zustand
gone_error	`CREDIT_EXPIRED`	410	Der Guthaben-Bucket ist abgelaufen und nicht mehr verfügbar
gone_error	`INVITATION_EXPIRED`	410	Die Einladung ist abgelaufen und nicht mehr gültig
invalid_request_error	`CHECKOUT_SESSION_CREATION_ERROR`	400	Fehler beim Erstellen der Kassen-Sitzung für die Zahlung
invalid_request_error	`CODE_VERIFICATION_FAILED`	400	Der Verifizierungscode ist ungültig oder abgelaufen
invalid_request_error	`CREDIT_AMOUNT_VALIDATION_ERROR`	400	Der angegebene Guthabenbetrag ist ungültig
invalid_request_error	`CURRENCY_MISMATCH`	400	Die Währung stimmt nicht mit der erwarteten Währung überein
invalid_request_error	`FREEZE_AMOUNT_NOT_SET`	400	Preisgestaltungskonfiguration ist erforderlich, bevor Vorhersagen gemacht werden
invalid_request_error	`HIGH_PRECISION_DECIMAL_VALIDATION_ERROR`	400	Der angegebene Dezimalwert ist ungültig oder hat zu viele Dezimalstellen
invalid_request_error	`INIT_PAYLOAD_QUEUE_NAME_MISSING`	400	Der Warteschlangenname ist in der Initialisierungsnutzlast erforderlich
invalid_request_error	`INVALID_CREDIT_AMOUNT`	400	Der angegebene Guthabenbetrag ist ungültig
invalid_request_error	`INVALID_PAYMENT_AMOUNT`	400	Der Zahlungsbetrag ist ungültig
invalid_request_error	`INVALID_PAYMENT_METHOD`	400	Die angegebene Zahlungsmethode ist ungültig
invalid_request_error	`INVALID_SUBSCRIPTION_DATA`	400	Die angegebenen Abonnementdaten enthalten ungültige Informationen
invalid_request_error	`INVALID_SUBSCRIPTION_OPERATION`	400	Die Abonnementoperation ist ungültig
invalid_request_error	`INVALID_VOID_METADATA`	400	Erforderliche Stornierungsmetadaten fehlen oder sind ungültig
invalid_request_error	`MISSING_PAYMENT_METHOD`	400	Für diese Operation ist eine Zahlungsmethode erforderlich
invalid_request_error	`MODEL_ENDPOINT_PRICE_ITEM_INVALID`	400	Die Preisgestaltungskonfiguration des Modellendpunkts ist ungültig
invalid_request_error	`MODEL_ENDPOINT_PRICE_TYPE_NOT_SUPPORTED`	400	Der Preistyp wird für diesen Modellendpunkt nicht unterstützt
invalid_request_error	`PAYMENT_VALIDATION_ERROR`	400	Die Zahlungsinformationen haben die Validierung nicht bestanden
invalid_request_error	`PREDICTION_INVALID_INPUT`	400	Die für die Vorhersage bereitgestellte Eingabe ist ungültig
invalid_request_error	`PREDICTION_FAILED`	400	Die Prediction, deren Ausgabe Sie angefordert haben, endete mit `status: "failed"`. `error.details` enthält den Prediction-Fehler.
invalid_request_error	`PRICE_TYPE_INVALID`	400	Der angegebene Preistyp ist ungültig
invalid_request_error	`PRICE_USAGE_KEY_MISSING`	400	Ein Nutzungsschlüssel ist für diesen Preistyp erforderlich
invalid_request_error	`PRICE_USAGE_VALUE_INVALID`	400	Der angegebene Nutzungswert ist ungültig
invalid_request_error	`PRICING_VALIDATION_ERROR`	400	Die Preisgestaltungskonfiguration hat die Validierung nicht bestanden
invalid_request_error	`SUBSCRIPTION_OPERATION_ERROR`	400	Die Abonnementoperation ist fehlgeschlagen
not_found_error	`API_KEY_NOT_FOUND`	404	Der angegebene API-Schlüssel existiert nicht
not_found_error	`CREDIT_BUCKET_NOT_FOUND`	404	Der angegebene Guthaben-Bucket existiert nicht
not_found_error	`CREDIT_PACKAGE_NOT_FOUND`	404	Das angegebene Guthabenpaket existiert nicht
not_found_error	`CUSTOMER_PROFILE_NOT_FOUND`	404	Das Kundenprofil konnte nicht gefunden werden
not_found_error	`FROZEN_CREDIT_NOT_FOUND`	404	Der eingefrorene Guthabendatensatz konnte nicht gefunden werden
not_found_error	`INVITATION_NOT_FOUND`	404	Die angegebene Einladung existiert nicht
not_found_error	`MODEL_ENDPOINT_NOT_FOUND`	404	Der angegebene Modellendpunkt existiert nicht
not_found_error	`MODEL_ENDPOINT_PRICE_ITEM_NOT_FOUND`	404	Die Preisgestaltungskonfiguration für diesen Modellendpunkt existiert nicht
not_found_error	`MODEL_ENDPOINT_PRICE_NOT_FOUND`	404	Für den angegebenen Modellendpunkt wurde keine Preisgestaltung gefunden
not_found_error	`MODEL_NOT_FOUND`	404	Das angegebene Modell existiert nicht
not_found_error	`MODEL_NOT_FOUND`	404	Das angegebene Modell existiert nicht
not_found_error	`MODEL_PROVIDER_NOT_FOUND`	404	Der angegebene Modellanbieter existiert nicht
not_found_error	`MODEL_PROVIDER_NOT_FOUND`	404	Der angegebene Modellanbieter existiert nicht
not_found_error	`ORGANIZATION_MEMBER_NOT_FOUND`	404	Das angegebene Organisationsmitglied existiert nicht
not_found_error	`ORGANIZATION_NOT_FOUND`	404	Die angegebene Organisation existiert nicht
not_found_error	`PAYMENT_METHOD_NOT_FOUND`	404	Die angegebene Zahlungsmethode existiert nicht
not_found_error	`PAYMENT_NOT_FOUND`	404	Die angegebene Zahlung existiert nicht
not_found_error	`PREDICTION_NOT_FOUND`	404	Die angegebene Vorhersage existiert nicht
not_found_error	`PREDICTION_NOT_FOUND`	404	Die angegebene Vorhersage existiert nicht
not_found_error	`PRICE_NOT_FOUND`	404	Die angegebene Preisgestaltungskonfiguration existiert nicht
not_found_error	`QUEUE_ITEM_NOT_FOUND`	404	Das angegebene Warteschlangenelement existiert nicht
not_found_error	`SERVICE_PROVIDER_NOT_FOUND`	404	Der angegebene Dienstanbieter existiert nicht
not_found_error	`SERVICE_PROVIDER_NOT_FOUND`	404	Der angegebene Dienstanbieter existiert nicht
not_found_error	`SUBSCRIPTION_NOT_FOUND`	404	Das angegebene Abonnement existiert nicht
not_found_error	`TASK_LOG_NOT_FOUND`	404	Das angegebene Aufgabenprotokoll existiert nicht
not_found_error	`TRANSACTION_NOT_FOUND`	404	Die angegebene Transaktion existiert nicht
not_found_error	`USER_NOT_FOUND`	404	Der angegebene Benutzer existiert nicht
precondition_failed_error	`INSUFFICIENT_CREDIT`	412	Unzureichendes Guthaben für diese Operation verfügbar
service_unavailable_error	`PREDICTION_UNAVAILABLE`	503	Der Vorhersagedienst ist derzeit nicht verfügbar
service_unavailable_error	`STRIPE_OPERATION_ERROR`	503	Der Zahlungsdienst ist derzeit nicht verfügbar
unprocessable_entity_error	`MODEL_ENDPOINT_PRICE_ITEM_MATCH_FAILED`	422	Passende Preisgestaltung für die Modellendpunktkonfiguration kann nicht gefunden werden
unprocessable_entity_error	`PREDICTION_UNSAFE_CONTENT`	422	Die Vorhersageeingabe enthält unsichere oder unangemessene Inhalte
unprocessable_entity_error	`PRICE_CALCULATION_ERROR`	422	Preis für die angeforderte Konfiguration kann nicht berechnet werden

Überblick

Multimodal

LLM

Client-Bibliotheken

Fehlercodes für fehlgeschlagene Predictions

Wo der Fehler bei Ihnen ankommt

Einen Fehler über den Result-Endpunkt lesen

Entscheiden, ob ein erneuter Versuch sinnvoll ist

`code`

`reason`

`input_validation_failed`

`provider_rejected_input`

`input_fetch_failed`

`moderation_blocked`

`provider_rate_limited`

`provider_unavailable`

`provider_timeout`

`provider_account_error`

`endpoint_misconfigured`

`queue_enqueue_failed`

`reaped_stalled`

Unbekannte Werte

Hinweis zur Migration: `error` ist `null`, wenn kein Fehler vorliegt

Bevorstehende Änderung: Einige Fehler erhalten einen spezifischeren `code`

API-Anfragefehler

​Fehlercodes für fehlgeschlagene Predictions

​Wo der Fehler bei Ihnen ankommt

​Einen Fehler über den Result-Endpunkt lesen

​Entscheiden, ob ein erneuter Versuch sinnvoll ist

​code

​reason

​input_validation_failed

​provider_rejected_input

​input_fetch_failed

​moderation_blocked

​provider_rate_limited

​provider_unavailable

​provider_timeout

​provider_account_error

​endpoint_misconfigured

​queue_enqueue_failed

​reaped_stalled

​Unbekannte Werte

​Hinweis zur Migration: error ist null, wenn kein Fehler vorliegt

​Bevorstehende Änderung: Einige Fehler erhalten einen spezifischeren code

​API-Anfragefehler

Fehlercodes für fehlgeschlagene Predictions

Wo der Fehler bei Ihnen ankommt

Einen Fehler über den Result-Endpunkt lesen

Entscheiden, ob ein erneuter Versuch sinnvoll ist

`code`

`reason`

`input_validation_failed`

`provider_rejected_input`

`input_fetch_failed`

`moderation_blocked`

`provider_rate_limited`

`provider_unavailable`

`provider_timeout`

`provider_account_error`

`endpoint_misconfigured`

`queue_enqueue_failed`

`reaped_stalled`

Unbekannte Werte

Hinweis zur Migration: `error` ist `null`, wenn kein Fehler vorliegt

Bevorstehende Änderung: Einige Fehler erhalten einen spezifischeren `code`

API-Anfragefehler