الانتقال إلى المحتوى الرئيسي
مفتاح بلا سقف هو مفتاح يستطيع استنزاف رصيد مساحة عملك بأكمله إذا دخل وكيل في حلقة. الطريقة الأكثر فعالية لتحديد نطاق انفجار وكيل مخترَق أو منفلت هي منح مفتاحه سقف إنفاق. على البوابة المُستضافة كل مفتاح إما غير محدود أو محدود بـ حصة مفتاح api مقاسة بالدولار الأمريكي — والاختيار حقل واحد في محرّر المفاتيح. تشرح هذه الصفحة الوضعين، وكيف يُفرَض السقف على مسار الترحيل، ومتى تختار أيّاً. للمجموعة الكاملة من القيود التي يحملها مفتاح — قوائم سماح النماذج، قوائم سماح IP، ربط السياسات — انظر كائن الرمز.

​
1. الوضعان

يُحَل كل مفتاح إلى إحدى حالتين بالضبط:

غير محدود

unlimited_quota = true. يسحب المفتاح من رصيد مساحة العمل دون سقف لكل مفتاح. لا يجري فحص إنفاق وقت الطلب — الحدّ الوحيد هو رصيد مساحة العمل نفسه.

محدود

credit_limit_usd > 0. يحمل المفتاح سقف إنفاقه مدى الحياة بالدولار. بمجرد أن يبلغ الإنفاق المتراكم السقف، يتوقف المفتاح عن العمل — بقية مساحة العمل سليمة.
تضبط هذا في شاشة المفاتيح بوحدة التحكم (/console/token). إنشاء مفتاح أو تعديله يتطلب دور Developer أو أعلى.
credit_limit_usd = 0 يعني بلا حدود — الصفر هو العلامة لـ “لا سقف”، وليس “سقف صفر دولار”. لتحديد مفتاح، أعطه مبلغاً موجباً بالدولار.

​
2. كيف تُفرَض حصة مفتاح api

عندما تضبط credit_limit_usd على رقم موجب، تحوّله البوابة إلى رصيد remain_quota داخلي لذلك المفتاح وتقلب unlimited_quota إلى false. من ثَمّ:
  • remain_quota هو مساحة الإنفاق المتبقية للمفتاح، تُسحَب مع فوترة الاستخدام.
  • used_quota هو الإنفاق المتراكم الذي حجزه المفتاح بالفعل.
  • في كل استدعاء ترحيل، تفحص البوابة المفتاح قبل أن تمرّر الطلب. مفتاح محدود بلغ remain_quota الخاص به صفراً يُرفض كـ مستنفَد — لا يصل الاستدعاء أبداً إلى النموذج.
مفتاح غير محدود (unlimited_quota = true) يتخطّى فحص الرصيد ذاك كلياً؛ إنه محدود فقط برصيد مساحة العمل وبأي حدود أخرى على مستوى المفتاح تضبطها (قائمة سماح نماذج، قائمة سماح IP، صلاحية).
المفتاح المحدود سقف مدى الحياة، لا ميزانية شهرية متجدّدة — يحسب السقف إجمالي الإنفاق على مدى عمر المفتاح. لميزانية تتجدّد، أصدر مفتاحاً محدوداً جديداً على وتيرتك الخاصة (مثل مفتاح جديد لكل سباق) وألغِ القديم. انظر إدارة المفاتيح.

​
3. مثال ملموس واحد

لنقل إنك تنشر وكيل تلخيص مجدوَل وتريد ضمان ألا ينفق أبداً أكثر من 25 دولاراً مهما فعل النموذج. اضبط السقف عند إنشاء المفتاح: 
// POST إلى شاشة المفاتيح بوحدة التحكم (Developer+).
// اضبط في وحدة التحكم — مفتاح الترحيل (sk-orca-…) لا يُستخدم أبداً
// لإدارة المفاتيح؛ يُقدَّم فقط على استدعاءات الاستدلال /v1/*.
{
  "name": "nightly-summarizer",
  "credit_limit_usd": 25,        // محدود: سقف مدى الحياة 25 دولاراً
  "model_limits_enabled": true,
  "model_limits": ["openai/gpt-4o-mini"],
  "expired_time": -1             // -1 = لا تنتهي الصلاحية أبداً
}
تخزّن البوابة هذا كمفتاح محدود: unlimited_quota = false و remain_quota بقيمة 25 دولاراً. يستدعي الوكيل النموذج بمفتاح الترحيل sk-orca-… كالمعتاد. لحظة بلوغ الإنفاق المتراكم 25 دولاراً، يُستنفَد المفتاح ويُرفض كل استدعاء /v1/* إضافي — دون مراقبتك لوحة معلومات، ودون لمس بقية مساحة العمل. لجعل المفتاح نفسه غير محدود لاحقاً، عدّله واقلب مفتاح غير محدود — تضبط وحدة التحكم unlimited_quota = true وcredit_limit_usd = 0 معاً، ويستطيع المفتاح السحب من رصيد مساحة العمل الكامل مجدداً.

​
4. أي وضع تختار

أي مفتاح يُسلَّم لوكيل مستقل، أو مهمة CI، أو تكامل طرف ثالث ينبغي أن يكون محدوداً. سقف الإنفاق أرخص ضمان بأن حلقة حقن مطالبة أو عاصفة إعادة محاولة لا يمكنها مراكمة فاتورة بلا حدود — يوقف السقف المفتاح قبل أن يتضاعف الضرر. أقرنه بـ حدّ نماذج صارم وقائمة سماح IP.
لمفتاح موجود فقط لعرض، أو اختبار حِمل، أو نشر واحد، اجمع credit_limit_usd صغيراً مع expired_time. يتقاعد المفتاح نفسه على أي حدّ يبلغه أولاً. انظر سقف الحصة والصلاحية و المفاتيح المنتهية الصلاحية.
مفتاح تستخدمه خدمة إنتاج أساسية تتحكم فيها بالكامل، حيث سقف لكل مفتاح سيسبّب أعطالاً زائفة فحسب، يمكن أن يبقى غير محدود — رصيد مساحة العمل هو شبكة الأمان. أبقِ هذه المفاتيح قليلة، وسمّها بوضوح، وحدّد نطاقها رغم ذلك بحدود النماذج وIP.
مفتاح محدود يُستنفَد في منتصف التشغيل يبدأ برفض الاستدعاءات فوراً. هذا هو المقصود — لكنه يعني أن وكيلاً غير مراقَب قد يتوقف في منتصف مهمة. حجّم السقف للعمل الذي تتوقعه، وراقب الإنفاق في عروض الاستخدام بوحدة التحكم بحيث تستطيع رفع السقف قبل أن يعضّ تشغيلاً شرعياً.

​
5. كيف تترابط حقول السقف

الحقول الثلاثة التي تحكم هذا هي مفتاح واحد برصيد مشتق — تضبط سقف الدولار، وتشتقّ البوابة البقية:
الحقلالمعنى
credit_limit_usdمدخلك. > 0 = سقف محدود بالدولار؛ 0 = غير محدود.
unlimited_quotatrue عندما لا يكون للمفتاح سقف؛ يُضبَط على false تلقائياً عند إعطائك credit_limit_usd موجباً.
remain_quotaمساحة إنفاق مشتقة لمفتاح محدود؛ بلوغ الصفر يستنفد المفتاح.
أنت تضبط دوماً credit_limit_usd فقط (أو unlimited_quota) في المحرّر. تُصان remain_quota وused_quota بواسطة البوابة مع فوترة المفتاح للاستخدام — إنها قياسات للقراءة فقط، تظهر في عروض الاستخدام بوحدة التحكم.

​
6. أين يقع هذا في مجموعة التحكم

سقف الإنفاق يحدّ كم يمكن لمفتاح فعله؛ وبقية نطاق المفتاح تحدّ ما يمكنه فعله. الاثنان يتركّبان:

سقف الحصة والصلاحية

اجمع سقف الدولار مع صلاحية مطلقة بحيث يتقاعد المفتاح نفسه على أي حدّ يبلغه أولاً.

كائن الرمز

كل حقل يحمله مفتاح — حدود النماذج، قائمة سماح IP، ربط السياسات، وسم البيئة — في مرجع واحد.

قائمة تحقّق الاستقلالية الأدنى

الوصفة الكاملة لأضيق مفتاح ممكن، قيداً تلو الآخر.

النطاق والمفاتيح والسياسات

كيف يلائم السقف تسلسل مساحة العمل ← السياسة ← المفتاح، وكيف يقلّص تحديد مفتاح نطاق الانفجار.
كلما ضاق سقف إنفاق كل مفتاح، صغُرت الفاتورة التي يمكن لأي وكيل مخترَق مراكمتها — وكان مسار تدقيقك أوضح لما كان كل مفتاح مخوَّلاً لإنفاقه.