الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

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

​
جسم الطلب

الحقلالنوعالقيم الافتراضية / القيودالوصف
namestringمطلوب، الافتراضي Default Key، الطول 1-50اسم العرض؛ تتم إزالة المسافات من البداية والنهاية على الخادم
limitAmountnumber | nullالحد الأدنى 0، الحد الأقصى 100000null أو الحذف = غير محدود، 0 = حصة صفرية، والقيمة الموجبة = سقف إنفاق بالدولار
limitCurrencyenumالقيمة الافتراضية USDاختياري: USD أو CNY. عند ضبطه على CNY سيتم تفسير limitAmount كقيمة بالرنمينبي ثم تحويلها إلى USD على الخادم قبل التخزين
modelsstring[]الافتراضي []قائمة اختيارية للنماذج المنطقية المسموح بها
expiresAtstring | nullتاريخ ووقت RFC3339null يعني عدم وجود انتهاء

​
ملاحظات

  • تظهر القيمة الكاملة لمفتاح API مرة واحدة فقط في الاستجابة.
  • تعني models: [] أن المفتاح لا يفرض قيودًا إضافية على النماذج خارج سياسة المؤسسة.
  • تؤدي limitAmount: 0 إلى إنشاء مفتاح صالح لكن من دون حصة قابلة للاستخدام إلى أن يتم تحديثه لاحقًا.
  • افتراضيًا يتم تفسير limitAmount على أنه USD. إذا أرسلت limitCurrency: "CNY" فسيتم التعامل مع الحد كقيمة بالرنمينبي ثم تحويله تلقائيًا إلى USD باستخدام سعر الصرف الحالي قبل تخزينه.
  • تتضمن الاستجابة exchange_rate بالإضافة إلى حقول العرض بالرنمينبي limit_amount_cny و used_amount_cny.

​
مثال

curl -X POST "https://api.lemondata.cc/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", "sora-2"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

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

استخدم لوحة OpenAPI التفاعلية أعلاه للاطلاع على المخطط الدقيق وحقول الاستجابة.