Zum Hauptinhalt springen
Die Infercom API verwendet standardmäßige HTTP-Response-Statuscodes, um anzuzeigen, ob eine API-Anfrage erfolgreich war oder fehlgeschlagen ist. Wenn eine Anfrage fehlschlägt, antwortet die API mit einem JSON-Objekt, das Details zum Fehler enthält. Diese umfassen:
  • Fehlercode
    • Identifiziert die Art des Fehlers.
  • Parameter (falls zutreffend)
    • Gibt die Eigenschaft an, die den Fehler verursacht.
  • Fehlermeldung
    • Bietet eine klare Erklärung des Problems.

​
Fehlermeldung

Diese Fehlermeldung zeigt an, dass ein Parameterwert das zulässige Maximum überschritten hat. Der Parameter top_p erhielt einen Wert von 100, während er zwischen 0 und 1 liegen sollte. Der Fehlertyp ist invalid_request_error mit dem Code decimal_above_max_value.
Beispiel Fehlermeldung
{
  "error": {
    "message": "Decimal above maximum value. Expected a value between 0 and 1, but got 100 instead.",
    "type": "invalid_request_error",
    "param": "top_p",
    "code": "decimal_above_max_value"
  }
}

​
Fehlerkategorien

Verwenden Sie die folgende Tabelle, um die verschiedenen Fehlerkategorien zu verstehen.
HTTP-StatusKategorieBeschreibungVorschlag
400Bad requestDer Server konnte die Anfrage aufgrund ungültiger Syntax oder Eingabewerte nicht verarbeiten.Überprüfen Sie die API-Anfrage-Syntax und Parameter.
401UnauthorizedAuthentifizierungsdaten fehlen oder sind ungültig.Stellen Sie sicher, dass ein gültiger API-Schlüssel/Token enthalten ist.
408Request timeoutDer Server hat die Anfrage aufgrund übermäßiger Verarbeitungszeit beendet.Wiederholen Sie die Anfrage mit optimierter Payload.
410GoneDas angeforderte Modell ist nicht mehr verfügbar (veraltet oder entfernt).Verwenden Sie ein aktuell unterstütztes Modell.
429Too many requestsRatenlimit für Ihre Abonnementstufe überschritten.Implementieren Sie Ratenbegrenzung oder upgraden Sie die Stufe.
429Queue FullZu viele Anfragen sind derzeit in Bearbeitung; der Server hat die Anfrage abgelehnt.Wiederholen Sie nach kurzer Verzögerung oder reduzieren Sie die Parallelität.
500Something went wrongEin serverseitiger Fehler ist aufgetreten.Wiederholen Sie später oder kontaktieren Sie den Support, falls anhaltend.
503MaintenanceDas Modell ist aufgrund von Wartungsarbeiten vorübergehend nicht verfügbar.Versuchen Sie es nach einiger Zeit erneut.

​
Fehlercode-Referenz

Verwenden Sie die folgende Tabelle, um Fehler programmatisch zu verstehen und zu beheben.
HTTP-StatusFehlercodeBeschreibungVorschlag
400context_length_exceededEingabe-/Ausgabe-Tokens überschreiten die Modell-Kontextgrenzen.Reduzieren Sie Prompt- und Antwortlänge, um innerhalb der Modellgrenzen zu bleiben.
invalid_typeParametertyp-Nichtübereinstimmung (z.B. int erwartet, aber float erhalten).Überprüfen Sie die erwarteten Parametertypen und korrigieren Sie die Eingabe.
decimal_above_max_valueDezimalwert überschreitet das zulässige Maximum.Passen Sie den Wert an, um in den zulässigen Bereich zu fallen.
decimal_below_min_valueDezimalwert liegt unter dem zulässigen Minimum.Erhöhen Sie den Wert, um die Mindestschwelle zu erfüllen.
integer_above_max_valueGanzzahlwert überschreitet das zulässige Maximum.Geben Sie eine kleinere Ganzzahl innerhalb des gültigen Bereichs an.
model_not_foundDie angegebene Modell-ID existiert nicht.Überprüfen Sie die Modell-ID und stellen Sie sicher, dass sie in Ihrem Abonnement verfügbar ist.
401invalid_authenticationUngültiger oder abgelaufener API-Schlüssel.Generieren und verwenden Sie einen gültigen API-Schlüssel aus dem Infercom-Portal.
408request_timeoutAnfrage aufgrund von Serverlast oder Latenz abgelaufen.Wiederholen Sie mit einer kleineren oder optimierten Anfrage-Payload. Erwägen Sie außerdem ein Upgrade auf eine höhere Abonnementstufe.
410model_deprecatedDas angeforderte Modell wurde veraltet und ist nicht mehr verfügbar.Verwenden Sie ein aktuell unterstütztes Modell, das in der Dokumentation aufgeführt ist.
429insufficient_quotaRatenlimit überschritten.Upgraden Sie Ihren Plan für höheres Kontingent.
429queue_fullZu viele laufende Anfragen; Server hat die Anfrage abgelehnt.Wiederholen Sie nach einer Verzögerung oder reduzieren Sie die Anfragehäufigkeit.
500internal_server_errorEin unerwarteter serverseitiger Fehler ist aufgetreten.Wiederholen Sie später. Wenn das Problem weiterhin besteht, kontaktieren Sie den Support.
503maintenanceModell ist aufgrund von Wartungsarbeiten vorübergehend nicht verfügbar.Versuchen Sie es nach einiger Zeit erneut oder prüfen Sie Wartungsankündigungen.