پرش به مستندات
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 است.

مرجع