الإدارة
جلب استخدام مفتاح API
يعيد تفاصيل استخدام مرقمة لصفحات لمفتاح API خاص بالمستخدم.
نظرة عامة
يعيد هذا الـ endpoint تفاصيل الاستخدام على مستوى مفتاح API من دون كشف بيانات التوجيه الفيزيائي.
معلمات الاستعلام
| المعامل | النوع | القيم الافتراضية / القيود | الوصف |
|---|---|---|---|
page | integer | الافتراضي 1، الحد الأدنى 1 | رقم الصفحة بدءًا من 1 |
limit | integer | الافتراضي 50، الحد الأدنى 1، الحد الأقصى 100 | حجم الصفحة |
model | string | أقصى طول 100 | اسم النموذج المطلوب |
modelVendor | string | أقصى طول 100 | مزود النموذج العام |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime |
startDate | string | - | حد سفلي شامل؛ يقبل RFC3339 مع منطقة زمنية أو YYYY-MM-DD |
endDate | string | - | حد علوي شامل؛ يقبل RFC3339 مع منطقة زمنية أو YYYY-MM-DD |
إذا تم إرسال startDate و endDate معًا، فيجب أن يكون startDate أسبق من أو مساويًا لـ endDate.
ملاحظات
-
تدعم حقول المبالغ المالية الدولار الأمريكي فقط.
-
هذه الاستجابة تدعم ترقيم الصفحات.
-
لا تتضمن الاستجابة إلا حقول الفوترة والتقارير العامة.
-
قد تتضمن كل سطر usage أيضاً الحقل
billing_transaction_idبعد اكتمال تسوية الطلب الأساسي. استخدمه معrequest_idللمطابقة على مستوى الطلب. -
يتم إخفاء بيانات التوجيه الداخلي والقنوات الفيزيائية عمدًا.
الطلب
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=chat&startDate=2026-07-01&endDate=2026-07-31" \
-H "Authorization: Bearer mt-your-management-token"الطلب / الاستجابة
توفّر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية أو برنامج العميل باستخدام 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-3-7-sonnet"
],
"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
},
"items": [
{
"request_id": "req_abc123",
"billing_transaction_id": "billtxn_abc123",
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"scene": "chat",
"usage_unit": "per_token",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500",
"prompt_tokens": 1000,
"completion_tokens": 500,
"total_tokens": 1500,
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"cache_write_tokens_5m": 0,
"cache_write_tokens_1h": 0,
"cost": 0.0012,
"cost_decimal": "0.0012",
"created_at": "2026-07-08T03:15:00.000Z",
"requested_policy": null,
"resolved_tier": null,
"charged_price_basis": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
},
"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"
}
]
}
}الحقول المهمة
page وlimit وtotal وtotalPages.per_token.auto, verified, official, null. سياسة التسليم المطلوبة، عند تسجيلها.verified, official, null. مستوى التسليم المستخدم، عند تسجيله.التفويض
ManagementTokenAuth مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.
الموضع: header
معاملات المسار
معاملات الاستعلام
رقم الصفحة يبدأ من 1. الافتراضي هو 1.
1 <= value1حجم الصفحة. الافتراضي هو 50 والحد الأقصى هو 100.
1 <= value <= 10050التصفية حسب اسم النموذج المطلوب. الحد الأقصى للطول 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.
عامل تصفية التاريخ الشامل. يقبل إما RFC3339 مع المنطقة الزمنية (على سبيل المثال 2026-03-28T00:00:00+08:00) أو YYYY-MM-DD.
الاستجابة
application/json
application/json
application/json
application/json
application/json