الإدارة

إنشاء API Key

إنشاء API key لـ Workspace الحالي.

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

نظرة عامة

أنشئ API key في Workspace المرتبط بـ management token. يظهر المفتاح السري الكامل مرة واحدة فقط في هذه الاستجابة.

جسم الطلب

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

ملاحظات

  • الحقول المالية هي بعملة USD فقط. تم إيقاف مدخلات CNY وتُرجع 400 currency_retired.

  • 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-v3.0"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

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

توفر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية (terminal) أو العميل الخاص بك باستخدام 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-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
}

حقول مهمة

keystring
القيمة السرية الكاملة لـ API key. يتم إرجاعها مرة واحدة فقط عند الإنشاء.
idstring
معرّف API key المستخدم في استدعاءات Management API اللاحقة.
namestring
اسم العرض لـ API key.
key_prefixstring
بادئة المفتاح غير السرية لأغراض العرض والدعم.
statusstring
واحد من active أو inactive أو suspended أو revoked.
limit_amountnumber | null
الحد الأقصى للإنفاق بـ USD كرقم JSON للعرض. تعني null غير محدود.
limit_amount_decimalstring | null
الحد الأقصى الدقيق للإنفاق بـ USD كسلسلة عشرية. تعني null غير محدود.
used_amountnumber
الاستخدام التراكمي بـ USD كرقم JSON للعرض.
used_amount_decimalstring
الاستخدام التراكمي الدقيق بـ USD كسلسلة عشرية.
modelsstring[]
قائمة النماذج المسموح بها لكل مفتاح. تعني المصفوفة الفارغة عدم وجود قيود إضافية على النماذج على مستوى المفتاح.
delivery_policystring | null
auto، verified، official، null. يرث null سياسة التسليم الخاصة بـ Workspace.
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