الإدارة
واجهة برمجة تطبيقات الإدارة
تحقق من أرصدة مساحة العمل (Workspace)، وأدر مفاتيح API، واسترجع بيانات الاستخدام والفواتير
استخدم Management API من الواجهة الخلفية (backend) الخاصة بك أو من خلال الأتمتة لإدارة مساحة عمل TokenLab. تستخدم هذه الواجهة رمز إدارة (management token)، لذا لا يحتاج البرنامج إلى مفتاح API عادي.
قم بإنشاء رمز إدارة في Dashboard → API → Management Tokens:
Authorization: Bearer mt-your-management-tokenرموز الإدارة (Management tokens) ومفاتيح API لها أدوار مختلفة. استخدم mt-... فقط مع /v1/management/*. واستخدم sk-... مع واجهات برمجة تطبيقات النماذج مثل /v1/responses.
Endpoints
| Endpoint | Method | Use |
|---|---|---|
/v1/management/balance | GET | الحصول على رصيد مساحة العمل |
/v1/management/api-keys | GET | سرد مفاتيح API |
/v1/management/api-keys | POST | إنشاء مفتاح API |
/v1/management/api-keys/{keyId} | PATCH | تغيير الاسم، أو الحد الأقصى، أو النماذج، أو تاريخ الانتهاء، أو الحالة |
/v1/management/api-keys/{keyId}/usage | GET | الحصول على سجلات الاستخدام الفردية |
/v1/management/api-keys/{keyId}/billing | GET | الحصول على ملخص الفواتير |
API Keys
- يظهر السر الكامل للمفتاح الجديد فقط في استجابة الإنشاء.
models: []تعني عدم وجود قيود على النماذج على مستوى المفتاح.limitAmount: nullتعني غير محدود. القيمة0تمنع المفتاح من تكبد أي تكاليف.- المبالغ تستخدم الدولار الأمريكي (USD). إرسال
CNYسيعيد الخطأ400 currency_retired. - يمكن إعادة تفعيل الحالة
inactive. استخدمrevokedلإلغاء المفتاح بشكل دائم.
Usage and Billing
يعيد /usage سجلات مقسمة إلى صفحات ويدعم عوامل التصفية حسب النموذج، ومُصنّع النموذج، والمشهد، والتاريخ. يمكن أن تتضمن السجلات المسواة billing_transaction_id؛ احفظه مع request_id عندما تحتاج إلى مطابقة رسوم مع طلب معين.
يعيد /billing الإجماليات مجمعة حسب النموذج، ومُصنّع النموذج، والمشهد، والتاريخ. ولا يتضمن عمليات شحن رصيد مساحة العمل أو الفواتير.
Example
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"