منهاج العمل

حساب API

ميزان القرآن، طلب التاريخ، مضادات الاستخدام، التكاليف، وأنقذ الدردشة بلاي

استخدام نقاط نهاية حساب عندما كنت ترغب في التوفيق الإنفاق، تظهر الاستخدام داخل منتجك الخاص، أو التصدير انقذ الاختبارات بلاي.

الاستخدام والتوازن

GET /v1/account/usage يعيد رصيد ائتمانك الحالي بالإضافة إلى حالات الاستخدام الأخيرة للحساب المرتبط بمفتاح API.

$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, or hosted_agents
model and endpointما كان يسمى بذلك. بالنسبة للصفوف GPU Cloud، model هو معرف وحدة معالجة الرسوميات.
tokensالإدخال، الإخراج، التخزين المؤقت، وإجمالي عدد الرموز. الصفوف غير المدعومة بالرموز، مثل أحداث وقت التشغيل GPU Cloud، تعطي عددا صفرا للرموز وتضع تفاصيل وقت التشغيل في metadata.
cost.amountمبالغ دائنة بدولارات الولايات المتحدة. وهذا هو المصدر الوحيد للحقيقة لما اتهم على هذا الطلب.
status, status_code, errorالنتيجة
output_urlsوسائط الإعلام المولدة عند وجودها
metadata.agent_type / metadata.agent_name / metadata.agent_instance_idهدية على مكالمات نموذجية العميل المضيف حتى تتمكن من تتبع العرف إلى العميل
metadata.gpu_slug / metadata.gpu_display / metadata.seconds / metadata.price_hourlyقدم في أحداث وقت التشغيل GPU 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" Plus 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}

The cost.amount already includes the per-tool surcharges (here: 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"

Retrieve a single conversation by ID, including its full message history:

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

إنقاذ و حذف دردشة بلاي وايلاند ما زالت تحدث في لوحة القيادة