الإدارة
الحصول على فواتير مفتاح API
إرجاع تفاصيل الفواتير المجمعة لمفتاح API الخاص بالمستخدم.
نظرة عامة
إرجاع إجمالي الإنفاق، وعدد الطلبات، والاستخدام القابل للفوترة، والتكلفة مجمعة حسب النموذج، ومزود النموذج، والمشهد، والتاريخ.
ملاحظات
-
الحقول النقدية هي بالدولار الأمريكي (USD) فقط.
-
لا يتم تضمين عمليات شحن رصيد مساحة العمل (Workspace) والفواتير.
-
يعني
endDateالذي يحتوي على تاريخ فقط الساعة 00:00 بالتوقيت العالمي المنسق (UTC) في بداية ذلك اليوم. لتضمين يوم كامل، استخدم التاريخ التالي أو وقت بتنسيق RFC3339. -
رمز الخطأ
429مع الكودreport_busyيعني أن قائمة انتظار التقارير ممتلئة. أعد المحاولة بعد عدد الثواني المحدد فيRetry-After.
مثال
يدعم نفس فلاتر النموذج، ومزود النموذج، والمشهد، والتاريخ المتاحة في استخدام مفتاح API. يُرجع الإجماليات بدون ترقيم صفحات.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31T23:59:59Z" \
-H "Authorization: Bearer mt-your-management-token"الطلب / الاستجابة
توفر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من جهازك الطرفي (terminal) أو العميل باستخدام Management Token؛ الإرسال المباشر غير متاح في هذه الصفحة.
الاستجابة
{
"api_key": {
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-sonnet-4-6"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
},
"summary": {
"total_requests": 1,
"total_cost": 0.0012,
"total_cost_decimal": "0.0012",
"total_prompt_tokens": 1000,
"total_completion_tokens": 500,
"total_tokens": 1500,
"usage_unit_breakdown": [
{
"usage_unit": "per_token",
"usage_quantity": 1500
}
]
},
"breakdowns": {
"by_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_logical_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_model_vendor": [
{
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012
}
],
"by_scene": [
{
"scene": "chat",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012"
}
],
"daily_cost": [
{
"date": "2026-07-08T00:00:00.000Z",
"cost": 0.0012,
"cost_decimal": "0.0012"
}
]
}
}حقول هامة
التفويض
ManagementTokenAuth مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.
الموضع: header
معاملات المسار
معاملات الاستعلام
التصفية حسب اسم النموذج المطلوب. الحد الأقصى للطول 100.
length <= 100التصفية حسب مزود النموذج العام. الحد الأقصى للطول 100.
length <= 100التصفية حسب مشهد الطلب العام.
القيم المتاحة
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
الحد الأدنى، شامل. يقبل تنسيق RFC3339 مع المنطقة الزمنية (على سبيل المثال 2026-03-28T00:00:00+08:00) أو YYYY-MM-DD، والذي يعني 00:00 بالتوقيت العالمي المنسق (UTC).
الحد الأعلى، شامل. يقبل تنسيق RFC3339 مع المنطقة الزمنية (على سبيل المثال 2026-03-28T23:59:59+08:00) أو YYYY-MM-DD، والذي يعني 00:00 بالتوقيت العالمي المنسق (UTC) في بداية ذلك اليوم. لتضمين يوم كامل، مرر تاريخ اليوم التالي أو وقت RFC3339 في نهاية اليوم.
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json