Obtenir l'usage par modèle

GET /api/open/v1/usage/models

Paramètres de requête

Paramètre	Emplacement	Type	Requis	Défaut	Description
start_timestamp	query	integer	Non	Voir ci-dessous	Date de début (incluse), secondes unix
end_timestamp	query	integer	Non	Voir ci-dessous	Date de fin (incluse), secondes unix
limit	query	integer	Non	10	Nombre de modèles à retourner, de 1 à 100 ; hors de cette plage, la réponse est 400

Règles de plage temporelle :

• Les deux omis : les 30 derniers jours.
• Seulement start_timestamp : 30 jours vers l’avant, plafonné à l’heure actuelle.
• Seulement end_timestamp : 30 jours vers l’arrière.
• La plage peut couvrir au maximum 366 jours.

Exemple de requête

curl "https://www.routeapi.ai/api/open/v1/usage/models?start_timestamp=1726400000&end_timestamp=1729000000&limit=10" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

Exemple de réponse

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "model_name": "gpt-4o",
        "prompt_tokens": 120000,
        "completion_tokens": 30000,
        "total_tokens": 150000,
        "amount": 3.20
      }
    ],
    "start_timestamp": 1726400000,
    "end_timestamp": 1729000000
  }
}

Champs de réponse

Champ	Type	Description
items[].model_name	string	Nom du modèle
items[].prompt_tokens	integer	Total des tokens d’entrée du modèle sur la plage
items[].completion_tokens	integer	Total des tokens de sortie du modèle sur la plage
items[].total_tokens	integer	Total des tokens d’entrée et de sortie
items[].amount	number	Montant consommé par le modèle, dans la devise du site, deux décimales
start_timestamp	integer	Date de début effective
end_timestamp	integer	Date de fin effective

Erreurs

HTTP	code	Scénario
400	invalid_request	limit n’est pas un entier entre 1 et 100, un timestamp est négatif, ou la plage temporelle est invalide
429	—	Limite de requêtes par utilisateur dépassée (30/minute par défaut) ; le corps peut être vide

Pour les autres codes d’erreur communs, voir Erreurs de l’API de la plateforme.

Remarques

• Les résultats sont triés par total_tokens décroissant ; en cas d’égalité, par nom de modèle croissant, l’ordre est donc stable.
• Le amount de chaque ligne est arrondi séparément ; la somme des lignes peut donc différer d’un total de jusqu’à 0,01.
• Seuls les logs de consommation (facturation) sont comptés ; les requêtes échouées sont exclues.
• Les nombres de tokens sont des comptes bruts, pas des millions.
• Les montants utilisent la devise d’affichage du site, voir Obtenir le solde.
• Cet endpoint partage la limite de requêtes par utilisateur (30/minute par défaut) avec Usage, Logs du compte, Exporter les logs et Usage par Key. Voir Limites de débit.