Passer au contenu principal
GET
Consulter le coût d'une requête
Cet endpoint permet de consulter le coût des appels d’API synchrones, principalement aux modèles de texte via les interfaces Chat Completions, Messages et Responses.Utilisez comme Request ID la valeur de l’en-tête X-Request-Id de la réponse initiale. Attendez un moment après la fin de la requête avant de la consulter. Pour les tâches asynchrones, utilisez Consulter le statut d’une tâche.

Autorisations

Authorization
string
header
requis

Tous les endpoints nécessitent une authentification par Bearer Token.

Obtenir une API Key :

Consultez la page de gestion des API Keys pour obtenir votre API Key.

Ajoutez l'en-tête suivant à la requête :

Paramètres de chemin

request_id
string
requis

Request ID issu de l'en-tête X-Request-Id de la réponse initiale. Omettez les accolades ({}) et ajoutez l'ID directement à la fin du chemin.

Maximum string length: 64

Réponse

Consultation réussie

id
string
requis

Request ID

Exemple:

"20261117223155519063884QnAx70lK"

object
enum<string>
requis

Type d'objet ; toujours request

Options disponibles:
request
Exemple:

"request"

model
string
requis

Modèle utilisé pour la requête

Exemple:

"claude-haiku-5-5"

status
enum<string>
requis

Statut de la requête :

  • completed : la requête a abouti.
  • failed : la requête a échoué. Si une utilisation a eu lieu avant l'échec, par exemple lors de l'interruption d'une réponse en streaming, usage indique les montants réellement débités.
  • blocked : la requête a été rejetée avant son traitement, par exemple en raison d'un solde insuffisant, d'un quota de clé API épuisé, d'une API Key désactivée ou expirée, ou d'un modèle non autorisé. Aucun frais n'est facturé.
Options disponibles:
completed,
failed,
blocked
Exemple:

"completed"

finished_at
integer
requis

Date de fin de la requête (horodatage Unix en secondes)

Exemple:

1794925917

usage
object
requis

Utilisation et coût. Toujours renvoyés ; toutes les valeurs sont à 0 si aucun frais n'a été facturé.

error
object

Motif de l'échec, renvoyé uniquement lorsque status vaut failed ou blocked. Contient seulement un message, sans code d'erreur. Pour traiter les erreurs par code, utilisez l'erreur renvoyée par la requête initiale.