TokenLab
Obtenir une clé API
DocumentationRéférence APIIntégrations

Gestion

Obtenir la facturation d'une clé API

Retourne les ventilations de facturation agrégées d'une clé API utilisateur.

GEThttps://api.tokenlab.sh/v1/management/api-keys/{keyId}/billing

Aperçu

Cet endpoint retourne des agrégats de facturation basés sur la consommation pour la clé API sélectionnée, notamment le coût total, le nombre total de requêtes, l’usage par unité de facturation, les ventilations by_model, by_logical_model, by_model_vendor et by_scene, ainsi qu’une tendance quotidienne des coûts.

Remarques

  • Les champs monétaires prennent uniquement en charge l’USD.

  • Les recharges, factures et autres écritures financières au niveau de l'organisation sont exclues.

Exemple

Accepte les mêmes filtres de modèle, fournisseur, scène et date que l’usage de la clé API. Renvoie les totaux sans pagination.

Requête

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31" \
  -H "Authorization: Bearer mt-your-management-token"

Demande / Réponse

Cette page fournit le schéma OpenAPI et des exemples de requêtes à copier. Envoyez les requêtes de gestion depuis votre terminal ou votre client avec un Management Token ; l’envoi direct n’est pas disponible sur cette page.

Exemple de réponse

Réponse

200 OK
{
  "api_key": {
    "id": "key_abc123def456",
    "name": "Backend Worker",
    "key_prefix": "sk-live...",
    "status": "active",
    "limit_amount": 500,
    "limit_amount_decimal": "500",
    "used_amount": 148.25,
    "used_amount_decimal": "148.25",
    "models": [
      "gpt-5.6-luna",
      "claude-3-7-sonnet"
    ],
    "expires_at": "2026-12-31T23:59:59.000Z",
    "last_used_at": "2026-07-08T03:12:45.000Z",
    "created_at": "2026-07-01T10:00:00.000Z",
    "delivery_policy": null
  },
  "summary": {
    "total_requests": 1,
    "total_cost": 0.0012,
    "total_cost_decimal": "0.0012",
    "total_prompt_tokens": 1000,
    "total_completion_tokens": 500,
    "total_tokens": 1500,
    "usage_unit_breakdown": [
      {
        "usage_unit": "per_token",
        "usage_quantity": 1500
      }
    ]
  },
  "breakdowns": {
    "by_model": [
      {
        "model": "gpt-5.6-luna",
        "logical_model": "gpt-5.6-luna",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_logical_model": [
      {
        "model": "gpt-5.6-luna",
        "logical_model": "gpt-5.6-luna",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_model_vendor": [
      {
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012
      }
    ],
    "by_scene": [
      {
        "scene": "chat",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ],
    "daily_cost": [
      {
        "date": "2026-07-08T00:00:00.000Z",
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ]
  }
}

Champs importants

api_keyobject
Résumé de la clé API utilisant les mêmes champs que les réponses de liste, de création et de mise à jour.
summaryobject
Totaux agrégés pour les filtres sélectionnés.
breakdownsobject
Ventilations agrégées pour les filtres sélectionnés.
summary.total_requestsnumber
Nombre total de requêtes.
summary.total_costnumber
Coût total en USD renvoyé sous forme de nombre JSON pour l’affichage.
summary.total_cost_decimalstring
Coût total exact en USD renvoyé sous forme de chaîne décimale.
summary.total_prompt_tokensnumber
Nombre total de tokens de prompt.
summary.total_completion_tokensnumber
Nombre total de tokens de complétion.
summary.total_tokensnumber
Nombre total de tokens.
summary.usage_unit_breakdownarray
Quantité d’utilisation regroupée par unité d’utilisation.
breakdowns.by_modelarray
Ventilation par modèle public demandé.
breakdowns.by_logical_modelarray
Ventilation par modèle public logique.
breakdowns.by_model_vendorarray
Ventilation par fournisseur de modèle public.
breakdowns.by_scenearray
Ventilation par scène de requête publique.
breakdowns.daily_costarray
Évolution quotidienne des coûts.

Autorisation

ManagementTokenAuth
AuthorizationBearer <token>

Authentification par jeton de gestion. Créez ou gérez vos jetons de gestion dans Dashboard > API > Management Tokens.

Emplacement: header

Paramètres de chemin

keyId*string

Paramètres de requête

model?string

Filtrer par nom de modèle demandé. Longueur maximale 100.

Longueurlength <= 100
modelVendor?string

Filtrer par fournisseur de modèle public. Longueur maximale 100.

Longueurlength <= 100
scene?string

Filtrer par scène de requête publique.

Valeurs possibles

  • "chat"
  • "image"
  • "audio"
  • "video"
  • "embedding"
  • "rerank"
  • "translation"
  • "music"
  • "3d"
  • "realtime"
  • "systemone"
startDate?string
endDate?string

Réponse

application/json

application/json

application/json

application/json

application/json

Obtenir l’usage d’une API Key

Précédent