Gestion
Obtenir la facturation d'une clé API
Renvoie les détails de facturation agrégés pour une clé API utilisateur.
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
endDatecomposé 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
429avec le codereport_busysignifie que la file d'attente des rapports est pleine. Réessayez après le nombre de secondes indiqué dansRetry-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 -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.
Réponse
{
"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
Autorisation
ManagementTokenAuth 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
Paramètres de requête
Filtrer par nom de modèle demandé. Longueur maximale 100.
length <= 100Filtrer par fournisseur de modèle public. Longueur maximale 100.
length <= 100Filtrer par scène de requête publique.
Valeurs possibles
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
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.
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