TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

الإدارة

إنشاء مفتاح API

ينشئ مفتاح API جديدًا للمستخدم في المؤسسة الحالية.

POSThttps://api.tokenlab.sh/v1/management/api-keys

نظرة عامة

ينشئ هذا الـ endpoint مفتاح API جديدًا من نوع type=user داخل المؤسسة المرتبطة برمز الإدارة الحالي.

جسم الطلب

الحقلالنوعالقيم الافتراضية / القيودالوصف
namestringاختياري، الافتراضي Default Key، الطول 1-50اسم العرض؛ تتم إزالة المسافات من البداية والنهاية على الخادم
limitAmountnumber | string | null0–100000 USDتعني null عدم وجود حد، وتمنع 0 الإنفاق. تدعم السلاسل العشرية حتى 6 منازل عشرية. عند إنشاء المفتاح، يعني حذف هذا الحقل عدم وجود حد.
limitCurrencyتعدادافتراضي USDUSD فقط. إرسال CNY يُرجع 400 currency_retired.
modelsstring[]الافتراضي []قائمة اختيارية للنماذج المنطقية المسموح بها
deliveryPolicystring | nullauto, verified, official, nullتعني null وراثة سياسة التسليم لمساحة العمل.
expiresAtstring | nullتاريخ ووقت RFC3339null يعني عدم وجود انتهاء

ملاحظات

  • تدعم حقول المبالغ المالية الدولار الأمريكي فقط. تم إيقاف مدخلات CNY وتعيد 400 currency_retired.

  • تظهر القيمة الكاملة لمفتاح API مرة واحدة فقط في الاستجابة.

  • تعني models: [] أن المفتاح لا يفرض قيودًا إضافية على النماذج خارج سياسة المؤسسة.

  • تؤدي limitAmount: 0 إلى إنشاء مفتاح صالح لكن من دون حصة قابلة للاستخدام إلى أن يتم تحديثه لاحقًا.

مثال

الطلب

cURL
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-3.0-video"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

الطلب / الاستجابة

توفّر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية أو برنامج العميل باستخدام Management Token؛ لا يتوفر الإرسال المباشر من هذه الصفحة.

مثال على الاستجابة

الاستجابة

201 Created
{
  "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-3.0-video"
  ],
  "expires_at": "2026-12-31T23:59:59.000Z",
  "last_used_at": null,
  "created_at": "2026-07-08T03:00:00.000Z",
  "delivery_policy": null
}

الحقول المهمة

keystring
القيمة السرية الكاملة لمفتاح API. تُعاد مرة واحدة فقط عند الإنشاء.
idstring
معرّف مفتاح API المستخدم في استدعاءات واجهة API للإدارة اللاحقة.
namestring
اسم العرض لمفتاح API.
key_prefixstring
بادئة مفتاح غير سرية للعرض والدعم.
statusstring
إحدى القيم active أو inactive أو suspended أو revoked.
limit_amountnumber | null
حد الإنفاق بالدولار الأمريكي كرقم JSON للعرض. تعني null عدم وجود حد.
limit_amount_decimalstring | null
حد الإنفاق الدقيق بالدولار الأمريكي كسلسلة عشرية. تعني null عدم وجود حد.
used_amountnumber
الإنفاق التراكمي للاستخدام بالدولار الأمريكي كرقم JSON للعرض.
used_amount_decimalstring
الإنفاق التراكمي الدقيق للاستخدام بالدولار الأمريكي كسلسلة عشرية.
modelsstring[]
قائمة النماذج المسموح بها لكل مفتاح. تعني المصفوفة الفارغة عدم وجود قيود إضافية على النماذج على مستوى المفتاح.
delivery_policystring | null
auto, verified, official, null. تعني null وراثة سياسة التسليم لمساحة العمل.
expires_atstring | null
طابع زمني ISO لانتهاء صلاحية المفتاح، أو null إذا لم تكن له مدة انتهاء.
last_used_atstring | null
طابع زمني ISO لأحدث استخدام، أو null إذا لم يُستخدم.
created_atstring
طابع زمني ISO للإنشاء.

التفويض

ManagementTokenAuth
AuthorizationBearer <token>

مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.

الموضع: header

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

عرض مفاتيح API

السابق

تحديث مفتاح API

التالي