मंच

खाता उपयोग एपीआई

क्वेरी बैलेंस, अनुरोध इतिहास, उपयोग काउंटर, लागत और सहेजी गई खेल का मैदान चैट

जब आप खर्च का मिलान करना चाहते हैं, अपने स्वयं के उत्पाद के अंदर उपयोग दिखाना चाहते हैं, या सहेजे गए प्लेग्राउंड परीक्षणों को निर्यात करना चाहते हैं, तो खाता समापन बिंदुओं का उपयोग करें।

उपयोग और संतुलन

GET /v1/account/usage आपके वर्तमान क्रेडिट बैलेंस के साथ-साथ एपीआई कुंजी से जुड़े खाते के लिए हाल के उपयोग की घटनाओं को लौटाता है।

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

आप from, to, before, model, status और source के आधार पर फ़िल्टर कर सकते हैं। समर्थित source मान api, playground, gpu_cloud और hosted_agents हैं।

प्रत्येक उपयोग घटना में शामिल हैं:

फ़ील्डअर्थ
sourceapi, playground, gpu_cloud या hosted_agents
model और endpointक्या कहा जाता था। GPU Cloud पंक्तियों के लिए, model GPU SKU पहचानकर्ता है।
tokensइनपुट, आउटपुट, कैश्ड और कुल टोकन मायने रखता है। गैर-टोकन-बिल वाली पंक्तियाँ, जैसे कि GPU Cloud रनटाइम इवेंट, शून्य टोकन गणना लौटाती हैं और रनटाइम विवरण metadata में डालती हैं।
cost.amountUSD में डेबिट क्रेडिट। इस अनुरोध पर जो आरोप लगाया गया था, उसके लिए यह सच्चाई का एकमात्र स्रोत है।
status, status_code, errorपरिणाम का अनुरोध करें
output_urlsमौजूद होने पर जेनरेट किए गए मीडिया URL
metadata.agent_type / metadata.agent_name / metadata.agent_instance_idहोस्टेड एजेंट मॉडल कॉल पर मौजूद रहें ताकि आप एजेंट के लिए उपयोग का पता लगा सकें।
metadata.gpu_slug / metadata.gpu_display / metadata.seconds / metadata.price_hourlyGPU Cloud रनटाइम ईवेंट पर उपस्थित रहें ताकि आप प्रदर्शन नाम, रनटाइम और प्रति घंटा दर को समेट सकें।
metadata.tool_usage\{tool_name: count\} का नक्शा जब एक मॉडल प्रति-उपकरण अधिभार (जैसे web_search, image_search, code_interpreter, web_extractor) बिल करता है। केवल तभी मौजूद रहें जब कम से कम एक उपकरण निकाल दिया गया हो।
metadata.list_cost / metadata.billed_cost / metadata.discount_amountकेवल तभी उपस्थित होता है जब खाता-स्तरीय मूल्य निर्धारण छूट लागू की गई हो. cost.amount पहले से ही छूट के बाद की राशि को दर्शाता है; ये फ़ील्ड रसीदों के लिए छूट का दस्तावेजीकरण करते हैं।

cost.amount हमेशा अंतिम डेबिट राशि होती है। metadata.list_cost/metadata.billed_cost जोड़ी सूचनात्मक है। जब छूट लागू की जाती है, तो cost.amount billed_cost के बराबर होता है। जब कोई छूट लागू नहीं होती है, तो कोई भी फ़ील्ड सेट नहीं होता है; बस cost.amount पढ़ें।

GPU Cloud ईवेंट के लिए, रनटाइम रिपोर्टिंग के लिए source: "gpu_cloud" प्लस metadata.seconds और metadata.price_hourly का उपयोग करें। tokens ऑब्जेक्ट स्कीमा स्थिरता के लिए प्रतिक्रिया में रहता है, लेकिन GPU रनटाइम पंक्तियाँ टोकन-बिल नहीं हैं।

उपकरण उपयोग उदाहरण

जब आप किसी ऐसे मॉडल को कॉल करते हैं जो प्रति-टूल अधिभार (Qwen, Perplexity, MiMo, Mistral) को बिल करता है और मॉडल उन उपकरणों को लागू करता है, तो प्रतिक्रिया में एक सामान्यीकृत tool_usage मानचित्र शामिल होता है:

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}

cost.amount में पहले से ही प्रति-उपकरण अधिभार (यहां: 2 × $0.026 web_search + 1 × $0.0208 image_search + token cost) शामिल हैं। tool_usage का उपयोग यह निर्धारित करने के लिए करें कि किन उपकरणों ने योगदान दिया।

सहेजी गई खेल का मैदान चैट

सार्वजनिक एपीआई सहेजे गए प्लेग्राउंड वार्तालापों को केवल-पढ़ने के लिए संसाधनों के रूप में उजागर करता है।

अपने सहेजे गए खेल के मैदान वार्तालापों की सूची बनाएं:

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

आईडी द्वारा एकल वार्तालाप पुनर्प्राप्त करें, जिसमें उसका पूरा संदेश इतिहास शामिल है:

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

खेल के मैदान चैट को सहेजना और हटाना अभी भी डैशबोर्ड में होता है।