Plattform

Kontonutzungs-API

Abfragesaldo, Anfrageverlauf, Nutzungszähler, Kosten und gespeicherte Playground-Chats

Verwenden Sie Konto-Endpunkte, wenn Sie Ausgaben abgleichen, die Nutzung in Ihrem eigenen Produkt anzeigen oder gespeicherte Playground-Tests exportieren möchten.

Verwendung und Balance

GET /v1/account/usage gibt deinen aktuellen Kreditbetrag plus aktuelle Nutzungsereignisse für das mit dem API-Schlüssel verbundene Konto zurück.

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

Sie können nach from, to, before, model, status und source filtern. Unterstützte source Werte sind api, playground, gpu_cloud und hosted_agents.

Jede Nutzungsveranstaltung umfasst:

SpielfeldBedeutung
sourceapi, playground, gpu_cloud oder hosted_agents
model und endpointWie hieß man. Für GPU Cloud Zeilen ist model die GPU-SKU-Identifikator.
tokensEingabe-, Ausgabe-, Zwischen- und Gesamtanzahl der Tokens. Nicht token-abgestellte Zeilen, wie GPU Cloud Laufzeitereignisse, geben null Token-Zahlen zurück und fügen Laufzeitdetails in metadata.
cost.amountBelastete Gutschriften in USD. Dies ist die einzige Wahrheitsquelle für das, was auf dieser Anfrage angeklagt wurde.
status, status_code, errorAnforderungsergebnis
output_urlsGenerierte Medien-URLs, wenn vorhanden
metadata.agent_type / metadata.agent_name / metadata.agent_instance_idPräsentieren Sie Hosted-Agent-Modellaufrufe, damit Sie die Nutzung auf den Agenten zurückverfolgen können.
metadata.gpu_slug / metadata.gpu_display / metadata.seconds / metadata.price_hourlyPräsentieren Sie auf der GPU Cloud Laufzeitereignisse, damit Sie den Anzeigename, die Laufzeit und den Stundensatz abgleichen können.
metadata.tool_usageAbbildung der \{tool_name: count\}, wenn ein Modell pro Werkzeug Zuschläge berechnete (z. B. web_search, image_search, code_interpreter, web_extractor). Nur vorhanden, wenn mindestens ein Werkzeug abgefeuert wurde.
metadata.list_cost / metadata.billed_cost / metadata.discount_amountNur dann vorhanden, wenn ein Preisabzug auf Kontoebene angewendet wurde. cost.amount spiegelt bereits den Betrag nach dem Abschlag wider; Diese Felder dokumentieren den Rabatt für Quittungen.

cost.amount ist immer der endgültig abgebuchte Betrag. Das metadata.list_cost / metadata.billed_cost Paar ist informativ. Wenn ein Rabatt angewendet wird, entspricht cost.amount billed_cost. Wenn kein Rabatt gilt, wird keines der Felder festgelegt; Lies einfach cost.amount.

Für GPU Cloud Ereignisse verwenden Sie source: "gpu_cloud" plus metadata.seconds und metadata.price_hourly für die Laufzeitberichterstattung. Das tokens-Objekt bleibt zur Schemastabilität in der Antwort, aber GPU-Laufzeitzeilen werden nicht token-abgestellt.

Werkzeug-Anwendungsbeispiel

Wenn man ein Modell aufruft, das pro Werkzeug Zuschläge abrechnet (Qwen, Perplexity, MiMo, Mistral) und das Modell diese Tools aufruft, enthält die Antwort eine normalisierte tool_usage Map:

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}

Die cost.amount beinhaltet bereits die Zuschläge pro Werkzeug (hier: 2 × $0.026 web_search + 1 × $0.0208 image_search + token cost). Nutze tool_usage, um zu analysieren, welche Werkzeuge beigetragen haben.

Gespeicherte Playground-Chats

Die öffentliche API stellt gespeicherte Playground-Konversationen als schreibgeschützte Ressourcen bereit.

Listen Sie Ihre gespeicherten Playground-Unterhaltungen auf:

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

Rufen Sie eine einzelne Konversation nach ID ab, einschließlich der vollständigen Nachrichtengeschichte:

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

Das Speichern und Löschen von Playground-Chats erfolgt weiterhin im Dashboard.