TokenLab

Gestion

Obtenir la facturation d'une clé API

Renvoie les détails de facturation agrégés pour une clé API utilisateur.

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

Aperçu

Renvoie le montant total dépensé, le nombre de requêtes, l'utilisation facturable et le coût regroupés par modèle, fournisseur de modèle, scène et date.

Remarques

  • Les champs monétaires sont uniquement en USD.

  • Les rechargements de compte et les factures de l'espace de travail ne sont pas inclus.

  • Un endDate composé uniquement d'une date correspond à 00:00 UTC au début de cette journée. Pour inclure une journée entière, utilisez la date suivante ou un format temporel RFC3339.

  • Un code 429 avec le code report_busy signifie que la file d'attente des rapports est pleine. Réessayez après le nombre de secondes indiqué dans Retry-After.

Exemple

Prend en charge les mêmes filtres de modèle, fournisseur de modèle, scène et date que l'utilisation 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-31T23:59:59Z" \
  -H "Authorization: Bearer mt-your-management-token"

Requête / Réponse

Cette page fournit le schéma OpenAPI et des exemples de requêtes copiables. 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-sonnet-4-6"
    ],
    "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/création/mise à jour.
summaryobject
Totaux agrégés pour les filtres sélectionnés.
breakdownsobject
Détails agrégés pour les filtres sélectionnés.
summary.total_requestsnumber
Nombre total de requêtes.
summary.total_costnumber
Coût total en USD sous forme de nombre JSON pour l'affichage.
summary.total_cost_decimalstring
Coût total exact en USD 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
Détail par modèle public demandé.
breakdowns.by_logical_modelarray
Détail par modèle public logique.
breakdowns.by_model_vendorarray
Détail par fournisseur de modèle public.
breakdowns.by_scenearray
Détail par scène de requête publique.
breakdowns.daily_costarray
Tendance du coût quotidien.

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

Borne inférieure, inclusive. Accepte le format RFC3339 avec fuseau horaire (par exemple 2026-03-28T00:00:00+08:00) ou YYYY-MM-DD, ce qui signifie 00:00 UTC.

endDate?string

Borne supérieure, inclusive. Accepte le format RFC3339 avec fuseau horaire (par exemple 2026-03-28T23:59:59+08:00) ou YYYY-MM-DD, ce qui signifie 00:00 UTC au début de ce jour. Pour inclure une journée entière, passez la date du jour suivant ou une heure RFC3339 à la fin de la journée.

Réponse

application/json

application/json

application/json

application/json

application/json

application/json