Zum Hauptinhalt springen
GET
Anfragekosten abfragen
Dieser Endpunkt fragt die Kosten synchroner API-Aufrufe ab, vor allem an Textmodelle über Schnittstellen wie Chat Completions, Messages und Responses.Verwenden Sie den Wert des Headers X-Request-Id aus der ursprünglichen Antwort als Request ID. Warten Sie nach Abschluss der Anfrage einen Moment, bevor Sie die Abfrage ausführen. Verwenden Sie für asynchrone Aufgaben Aufgabenstatus abfragen.

Autorisierungen

Authorization
string
header
erforderlich

Alle Endpunkte erfordern eine Authentifizierung mit Bearer Token.

API Key erhalten:

Rufen Sie die API-Key-Verwaltung auf, um Ihren API Key zu erhalten.

Fügen Sie den folgenden Anfrageheader hinzu:

Pfadparameter

request_id
string
erforderlich

Request ID aus dem Header X-Request-Id der ursprünglichen Antwort. Lassen Sie die geschweiften Klammern ({}) weg und hängen Sie die ID direkt an den Pfad an.

Maximum string length: 64

Antwort

Abfrage erfolgreich

id
string
erforderlich

Request ID

Beispiel:

"20261117223155519063884QnAx70lK"

object
enum<string>
erforderlich

Objekttyp; immer request

Verfügbare Optionen:
request
Beispiel:

"request"

model
string
erforderlich

Das für die Anfrage verwendete Modell

Beispiel:

"claude-haiku-5-5"

status
enum<string>
erforderlich

Anfragestatus:

  • completed: Die Anfrage wurde erfolgreich abgeschlossen.
  • failed: Die Anfrage ist fehlgeschlagen. Wenn vor dem Fehler bereits Nutzung angefallen ist, etwa bei einer unterbrochenen Streaming-Antwort, enthält usage die tatsächlich abgebuchten Kosten.
  • blocked: Die Anfrage wurde vor der Verarbeitung abgelehnt, etwa wegen eines unzureichenden Kontoguthabens, eines ausgeschöpften API-Key-Kontingents, eines deaktivierten oder abgelaufenen API Keys oder eines nicht zugelassenen Modells. Es fallen keine Kosten an.
Verfügbare Optionen:
completed,
failed,
blocked
Beispiel:

"completed"

finished_at
integer
erforderlich

Endzeit der Anfrage (Unix-Zeitstempel in Sekunden)

Beispiel:

1794925917

usage
object
erforderlich

Nutzung und Kosten. Wird immer zurückgegeben; wenn keine Kosten angefallen sind, sind alle Werte 0.

error
object

Fehlerursache; wird nur zurückgegeben, wenn status den Wert failed oder blocked hat. Enthält nur eine Beschreibung, keinen Fehlercode. Verwenden Sie für eine Verarbeitung nach Fehlercode den Fehler aus der ursprünglichen Anfrage.