الإدارة
إنشاء API Key
إنشاء API key لـ Workspace الحالي.
نظرة عامة
أنشئ API key في Workspace المرتبط بـ management token. يظهر المفتاح السري الكامل مرة واحدة فقط في هذه الاستجابة.
جسم الطلب
| الحقل | النوع | الافتراضي / القيود | ملاحظات |
|---|---|---|---|
name | string | اختياري، القيمة الافتراضية Default Key، الطول 1-50 | اسم العرض، يتم اقتطاع المسافات الزائدة من جانب الخادم |
limitAmount | number | string | null | 0–100000 USD | تعني null غير محدود؛ وتمنع 0 الإنفاق. تدعم السلاسل النصية العشرية ما يصل إلى 6 منازل عشرية. حذف هذا الحقل عند إنشاء مفتاح يعني أنه غير محدود. |
limitCurrency | enum | افتراضيًا USD | USD فقط. يؤدي إرسال CNY إلى إرجاع 400 currency_retired. |
models | string[] | افتراضيًا [] | قائمة النماذج المسموح بها (اختيارية) |
deliveryPolicy | string | null | auto, verified, official, null | يرث null سياسة التسليم الخاصة بـ Workspace. |
expiresAt | string | null | RFC3339 datetime | تعني null عدم وجود انتهاء صلاحية |
ملاحظات
-
الحقول المالية هي بعملة USD فقط. تم إيقاف مدخلات
CNYوتُرجع400 currency_retired. -
models: []لا يضيف أي قيود على النماذج على مستوى المفتاح. -
limitAmount: 0يُنشئ مفتاحًا صالحًا ولكنه لا يمكنه إنفاق الحصة حتى يتم تحديثه.
الطلب
curl -X POST "https://api.tokenlab.sh/v1/management/api-keys" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"name": "Backend Worker",
"limitAmount": 500,
"models": ["veo3.1", "kling-v3.0"],
"expiresAt": "2026-12-31T23:59:59Z"
}'الطلب / الاستجابة
توفر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية (terminal) أو العميل الخاص بك باستخدام Management Token؛ الإرسال المباشر غير متاح في هذه الصفحة.
الاستجابة
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key": "sk-live-redacted",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 0,
"used_amount_decimal": "0",
"models": [
"veo3.1",
"kling-v3.0"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": null,
"created_at": "2026-07-08T03:00:00.000Z",
"delivery_policy": null
}حقول مهمة
active أو inactive أو suspended أو revoked.null غير محدود.null غير محدود.auto، verified، official، null. يرث null سياسة التسليم الخاصة بـ Workspace.null لعدم وجود تاريخ انتهاء.null في حال لم يُستخدم بعد.التفويض
ManagementTokenAuth مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.
الموضع: header
جسم الطلب
application/json
الاستجابة
application/json
application/json
application/json
application/json