تخطَّ إلى المستندات
API

قراءة سجل الاستخدام

الإرسالات وإجراءات الذكاء الاصطناعي يوميًا، وما يكلّفه الاستخدام الإضافي للدفع حسب الاستخدام شهريًا.

GET/billing/usage

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

GET /billing/usage

الإرسالات وإجراءات الذكاء الاصطناعي يوميًا، وما يكلّفه الاستخدام الإضافي للدفع حسب الاستخدام شهريًا.

مثال

يتطلب billing:read. يعود days من 1 إلى 3660 يومًا، و30 افتراضيًا، ويعود all إلى اليوم الذي أُنشئت فيه مساحة العمل. ويعدّ aiExtra إجراءات الذكاء الاصطناعي التي تجاوزت الحصة اليومية، والتي فوترها الدفع حسب الاستخدام.

curl
curl "$OE/billing/usage?days=7" -H "$AUTH"
الاستجابة
{  "object": "usage_history",  "days": [    { "day": "2026-10-02", "aiActions": 14, "aiExtra": 0, "sends": 2210 },    { "day": "2026-10-03", "aiActions": 9, "aiExtra": 0, "sends": 1870 }  ],  "months": [    {      "month": "2026-09",      "extraSends": 3000,      "extraAiActions": 0,      "sendCents": 120,      "aiCents": 0,      "cents": 120    }  ],  "dailyAiActions": 150,  "monthlySends": 200000}

لا يصل إلى الفوترة إلا مالك مساحة العمل: مفتاح API، أو رمز وصول ربطه المالك بكل العناوين. رمز العضو يعيد 403 owner_only، والمفتاح أو الرمز المقيّد بعناوين أو نطاقات معيّنة يعيد 422 capability_unsupported.

المرجع