Quai

API d’utilisation des comptes

Balance des requêtes, historique des requêtes, compteurs d’utilisation, coûts et discussions Playground sauvegardées

Utilisez les points de terminaison des comptes lorsque vous souhaitez rapprocher les dépenses, afficher l’utilisation dans votre propre produit ou exporter des tests Playground sauvegardés.

Utilisation et équilibre

GET /v1/account/usage renvoie votre solde de crédit actuel ainsi que les événements d’utilisation récents du compte associé à la clé API.

$curl "https://api.empiriolabs.ai/v1/account/usage?limit=25" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Vous pouvez filtrer par from, to, before, model, status et source. Les valeurs source soutenues sont api, playground, gpu_cloud et hosted_agents.

Chaque événement d’utilisation comprend:

TerrainSignification
sourceapi, playground, gpu_cloud ou hosted_agents
model et endpointComment on appelait. Pour GPU Cloud lignes, model est l’identifiant du SKU GPU.
tokensEntrée, sortie, mise en cache et total des tokens. Les lignes non facturées par jetons, telles que les événements d’exécution GPU Cloud, renvoient zéro nombre de jetons et mettent les détails d’exécution dans metadata.
cost.amountDébit de crédits en USD. C’est la seule source de vérité pour ce qui a été reproché à cette demande.
status, status_code, errorRésultat de la demande
output_urlsURL médias générées lorsqu’elles sont présentes
metadata.agent_type / metadata.agent_name / metadata.agent_instance_idPrésentez les appels modèles d’agent hébergé pour pouvoir retracer l’utilisation jusqu’à l’agent.
metadata.gpu_slug / metadata.gpu_display / metadata.seconds / metadata.price_hourlyPrésentez sur les événements d’exécution du GPU Cloud pour pouvoir concilier le nom d’affichage, l’exécution et le taux horaire.
metadata.tool_usageCarte de \{tool_name: count\} lorsqu’un modèle facturait des surtaxes par outil (par exemple web_search, image_search, code_interpreter, web_extractor). Présent uniquement lorsqu’au moins un outil a été tiré.
metadata.list_cost / metadata.billed_cost / metadata.discount_amountPrésent uniquement lorsqu’une remise de prix au niveau du compte a été appliquée. cost.amount reflète déjà le montant après escompte; Ces champs indiquent la remise pour les reçus.

cost.amount est toujours le montant final débité. Le duo metadata.list_cost / metadata.billed_cost est informatif. Lorsqu’une remise est appliquée, cost.amount est égal à billed_cost. Lorsqu’aucun rabais ne s’applique, aucun champ n’est défini; Lisez cost.amount.

Pour GPU Cloud événements, utilisez source: "gpu_cloud" plus metadata.seconds et metadata.price_hourly pour le rapport en temps réel. L’objet tokens reste dans la réponse pour la stabilité du schéma, mais les lignes d’exécution GPU ne sont pas facturées par jeton.

Exemple d’utilisation des outils

Lorsque vous appelez un modèle facturant des surtaxes par outil (Qwen, Perplexity, MiMo, Mistral) et que le modèle invoque ces outils, la réponse inclut une carte de tool_usage normalisée:

1{
2  "id": "...",
3  "object": "usage_event",
4  "model": "qwen3-6-plus",
5  "cost": { "amount": 0.084, "currency": "USD" },
6  "tokens": { "input": 1250, "output": 480, "total": 1730 },
7  "metadata": {
8    "tool_usage": {
9      "web_search": 2,
10      "image_search": 1
11    }
12  }
13}

Le cost.amount inclut déjà les surtaxes par outil (ici: 2 × $0.026 web_search + 1 × $0.0208 image_search + token cost). Utilisez tool_usage pour décomposer les outils qui ont contribué.

Discussions Playground Saved

L’API publique expose les conversations Playground sauvegardées comme des ressources en lecture seule.

Listez vos conversations Playground sauvegardées:

$curl "https://api.empiriolabs.ai/v1/playground/conversations" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Récupérez une seule conversation par identifiant, y compris son historique complet des messages:

$curl "https://api.empiriolabs.ai/v1/playground/conversations/CONVERSATION_ID" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Sauvegarder et supprimer les discussions de Playground se fait toujours dans le tableau de bord.