Consulter l’utilisation d’une clé API
Management key required. Renvoie les nombres de requêtes et les coûts facturés en USD d’une clé, même supprimée.
api_key_id dans l’URL correspond au champ id, au format ak_..., renvoyé par Créer une clé API de modèle (POST /public/v1/api-keys). Conservez-le pour désactiver ou supprimer la clé, définir son plafond et consulter son utilisation. Le champ key (apikey-...) sert aux appels de modèles ; les appels de gestion utilisent toujours mgmt-... dans l’en-tête d’autorisation.
Management key required. Use a Management API Key (mgmt-...) for your Team, created by a Team Owner. Requests use the Team associated with that key.
Includes disabled, expired and deleted keys and keys in archived projects. Only API-key-based sources are counted; a user with the same internal ID is excluded. See ResourceUsage for accounting semantics. Unknown or repeated query parameters are rejected.
Authorization
ManagementKeyBearer Management key required. Send Authorization: Bearer mgmt-....
In: header
Path Parameters
The id returned by Create a model API key (POST /public/v1/api-keys). Copy the complete ak_... value into this path parameter. Use the mgmt-... management key in the authorization header; the returned key (apikey-...) is for model calls.
^ak_[0-9A-Za-z]{22}$Query Parameters
Inclusive RFC 3339 start after the Unix epoch, aligned to a UTC hour boundary. Maximum window is 31 days.
date-timeExclusive RFC 3339 end, aligned to a UTC hour boundary and strictly after from.
date-timeResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage?from=2026-11-01T00%3A00%3A00Z&to=2026-11-02T00%3A00%3A00Z"{ "object": "api_key_usage", "api_key_id": "ak_0123456789ABCDEFGHIJKL", "from": "2026-11-01T00:00:00Z", "to": "2026-11-02T00:00:00Z", "requests": 12, "successes": 10, "failures": 2, "amount": { "value": "1.230000", "currency": "usd" }, "request_id": "req_example"}Last updated on
Remplacer le plafond d’une clé API PUT
Management key required. Définit un plafond illimité, fixe ou périodique sans réinitialiser l’utilisation.
Obtenir le solde du compte GET
Model API key required. Renvoie le solde actuel et le récapitulatif des crédits accordés pour le compte de la clé API authentifiée.