Passer au contenu principal

Vue d’ensemble

Cet endpoint renvoie les détails d’usage au niveau de la clé sans exposer les métadonnées de routage physique.

Paramètres de requête

ParamètreTypeValeurs par défaut / limitesDescription
pageintegervaleur par défaut 1, min. 1Numéro de page à partir de 1
limitintegervaleur par défaut 50, min. 1, max. 100Nombre d’éléments par page
logicalModelstringlongueur maximale 100Nom du modèle logique demandé
modelVendorstringlongueur maximale 100Fournisseur public du modèle
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform ou byok
startDatestring-Borne inférieure incluse ; accepte RFC3339 avec fuseau horaire ou YYYY-MM-DD
endDatestring-Borne supérieure incluse ; accepte RFC3339 avec fuseau horaire ou YYYY-MM-DD
Si startDate et endDate sont fournis ensemble, startDate doit être antérieur ou égal à endDate.

Notes

  • Les champs monétaires sont réservés au USD. Les entrées CNY sont obsolètes et renvoient 400 currency_retired.
  • La réponse est paginée.
  • La réponse ne contient que des champs publics de billing et de reporting.
  • Une ligne d’usage peut aussi inclure billing_transaction_id une fois que la requête sous-jacente a été réglée. Utilisez-le avec request_id pour le rapprochement au niveau de la requête.
  • Les métadonnées de routage interne et de canaux physiques restent masquées.

Exemple

curl "https://api.aisonar.dev/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&accessChannel=platform&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

Requête / Réponse

Utilisez le panneau OpenAPI interactif ci-dessus pour obtenir le schéma exact et les champs de réponse.