ميزانية Vercel AI Gateway لكل مستخدم: حدّ الإنفاق الفردي بلا تعطيل الإنتاج

مع ميزانية Vercel AI Gateway لكل مستخدم، لم يعد على وكيل برمجة منفلت أن يشترك مع تطبيق الإنتاج في مفتاح إيقاف مالي واحد. ففي 31 أغسطس 2026، أضافت Vercel AI Gateway ميزانيات لكل مستخدم؛ وبذلك يمكن إيقاف الإنفاق الصادر من مفاتيح API المنسوبة إلى عضو واحد، بينما يواصل مفتاح الإنتاج المنسوب إلى الفريق العمل، ما دامت هناك ميزانية متبقية لكل من المفتاح والفريق. ما تغيّر هنا هو طريقة تحكّم الفريق في الفاتورة، لا تكلفة النموذج.

ميزانية Vercel AI Gateway في جملة واحدة

امنح المفاتيح الشخصية لوكلاء البرمجة مخصصًا لكل فرد، وأبقِ مفاتيح الإنتاج المشتركة مملوكة للفريق.

هذه هي الآلية كاملة. تجمع ميزانية المستخدم إنفاق جميع مفاتيح AI Gateway API المنسوبة إلى العضو نفسه. وعندما ينفد ذلك المخصص، تعيد الطلبات الجديدة عبر تلك المفاتيح استجابة HTTP 402، بينما يمكن لحركة المرور الواقعة خارج ميزانية ذلك المستخدم أن تستمر.

قبل هذا الإصدار، كانت Vercel تتيح وضع سقف للفريق أو لمشروع أو لمفتاح API واحد. ويأتي نطاق المستخدم الجديد إلى جانب تلك الضوابط ليعالج مشكلة مختلفة: قد يستخدم مطوّر واحد عدة مفاتيح عبر Codex أو Claude Code أو Cursor أو أي عبء عمل آخر يعمل بلا إشراف، لكن الإدارة المالية تظل بحاجة إلى سقف واحد لإجمالي إنفاق ذلك الشخص عبر البوابة.

ما الإنفاق الذي يُحتسب على المستخدم فعلًا؟

الإعداد الأهم هو إسناد الإنفاق؛ أي تسمية الملكية التي تربطها Vercel بمفتاح API لأغراض احتساب الميزانية.

يكون إسناد المفاتيح الجديدة افتراضيًا إلى User. أما المفاتيح الأقدم التي لا تحمل إسنادًا للإنفاق، فتبقى منسوبة إلى Team حفاظًا على التوافق مع الإصدارات السابقة. كذلك يُحتسب المفتاح المنشأ عبر API من دون metadata.spendAttribution على Team.

ينتج عن ذلك أربعة مسارات مختلفة للطلبات:

لا يُقسَّم الإنفاق بين هذه الميزانيات، بل يُسجَّل في كل عدّاد منطبق في الوقت نفسه. فالطلب الذي يستخدم مفتاحًا منسوبًا إلى عضو يجب أن يبقى ضمن ميزانية المفتاح وميزانية ذلك المستخدم وميزانية الفريق. وإذا نَفِدت أي واحدة منها، يتوقف الطلب.

هنا تحديدًا تحتاج حركة الإنتاج المشتركة إلى قرار مقصود. فإذا أنشأ مطوّر مفتاحًا جديدًا لتطبيق يتعامل معه العملاء، يُنسب المفتاح افتراضيًا إلى ذلك المطوّر، وقد يؤدي نفاد مخصصه الشخصي إلى إيقاف التطبيق. لذلك غيّر خيار Spend attribution للمفتاح إلى Team من صفحة AI Gateway API Keys، حتى لا تنطبق عليه إلا ميزانية المفتاح وميزانية الفريق.

كيف غيّرت حدود الإنفاق المعادلة المالية؟

تحوّل الحدود المخصصة لكل مستخدم مخاطرَ الإنفاق المشترك إلى مخصصات يمكن توزيعها قبل وصول الفاتورة.

لنأخذ مثالًا افتراضيًا، لا سعرًا من Vercel. لنفترض أن فريقًا من 8 أشخاص لديه ميزانية شهرية للفريق قدرها $1,000. يحصل سبعة أعضاء على حد افتراضي شهري قدره $50، بينما يحصل قائد واحد على ميزانية مخصصة قدرها $150 لأن دوره يتطلب تشغيل وكلاء أكثر كثافة.

يصبح إجمالي السقف المتاح للمفاتيح الشخصية:

7 × $50 + 1 × $150 = $500 per month

لا تقع هذه الـ$500 خارج ميزانية الفريق، بل داخلها. إذا استهلكت المفاتيح المنسوبة إلى الأعضاء كامل الـ$500 أولًا، فستُحتسب الـ$500 نفسها أيضًا من سقف الفريق البالغ $1,000. وفي هذه الحالة المبسطة، يتبقى $500 قبل بلوغ حد الفريق، ويمكن استخدامها لحركة الإنتاج المنسوبة إلى الفريق.

مع ذلك، لا يُحجز أي مبلغ مسبقًا. فقد يسبق إنفاق الإنتاج غيره، وكل طلب يحتاج دائمًا إلى مساحة متبقية تحت سقف الفريق. الفائدة الجديدة أكثر تحديدًا: لا يستطيع عضو واحد استهلاك أكثر من مخصصه عبر المفاتيح المنسوبة إليه قبل أن يفقد الجميع الوصول.

يختلف ذلك عن آلية التحكّم الأصلية لدى OpenAI، حيث يحتاج الوكيل إلى مشروع مستقل كي يحصل على سقف مشروع مُلزم. يشرح دليل التحكّم في ميزانية OpenAI API نموذج العزل هذا. أما نطاق المستخدم في Vercel، فيمكنه تغطية عدة مفاتيح منسوبة إلى العضو من دون إنشاء مشروع مستقل لكل شخص.

لا تخفّض الميزة أسعار الرموز. فما زالت AI Gateway تفرض أسعار قوائم المزوّدين من دون هامش إضافي على الرموز أو رسوم منصة. المكسب هو احتواء الخسائر وتوضيح الملكية، لا جعل الاستدلال أرخص.

أربعة فرق سيتغيّر سير عملها فعليًا

قائد هندسة منتجات يدير عدة وكلاء برمجة

ضع ميزانية مستخدم افتراضية واحدة للفريق، ثم امنح المستخدمين ذوي الأحمال الأكبر مبالغ مخصصة. يستطيع المطوّر تشغيل وكلاء مختلفين بمفاتيح منفصلة، مع استمرار تجميع إنفاق جميع تلك المفاتيح ضمن سقف شخصي واحد.

المكسب هو ضبط حلقة العمل الليلية بحد واضح. فإذا استمر وكيل واحد في إعادة محاولة مهمة فاشلة، تتوقف طلبات ذلك المطوّر من دون أن يؤدي ذلك تلقائيًا إلى تعطيل خدمة إنتاج منسوبة إلى الفريق.

مشغّل وكالة يحمي هامش مشروعات العملاء

امنح كل مشغّل مفتاحًا منسوبًا إليه ومخصصًا افتراضيًا. ثم أضف ميزانية مخصصة للشخص الذي يتولى ترحيلًا كثيف الاستخدام للنماذج أو دفعة عمل قصيرة لأحد العملاء.

المكسب هو استثناء محدد بالاسم. يمكن اعتماد إنفاق أكبر لشخص واحد من دون رفع مخصصات جميع الزملاء أو جعل ميزانية الوكالة بأكملها قاطع الأمان الوحيد.

قائد منصة يفصل استخدام الأفراد عن الإنتاج

راجع كل مفتاح في AI Gateway، وعيّن الخدمات المشتركة إلى Team، مع إبقاء مفاتيح وكلاء البرمجة الشخصية منسوبة إلى منشئيها.

المكسب هو عزل الأعطال. فنفاد مخصص شخص ما يوقف حركة وكلائه، بينما يستمر عبء العمل الموجّه للعملاء إلى أن تنفد ميزانية مفتاحه أو ميزانية الفريق.

قائد مالية أو عمليات يتولى السياسة

يمكن لصاحب دور Owner منح صلاحية AI Gateway Budget Manager من دون تسليم دور Owner كاملًا. يتيح ذلك للمشغّل إدارة ميزانيات المستخدمين والإعدادات الافتراضية وإسناد المفاتيح، فيما تستطيع جميع أدوار الفريق باستثناء Contributor الاطلاع على صفحات الميزانية.

المكسب هو وجود مسؤول تشغيلي فعلي. تحدد الإدارة المالية السقف، وتراه الهندسة، ولا ينتظر تعديل الميزانية الشخص الوحيد الذي يملك فريق Vercel بأكمله.

اضبط ميزانيات المستخدمين من دون ربط الإنتاج بشخص

تتطلب ميزانيات المستخدمين في Vercel الإصدار 59.6.2 أو أحدث من CLI. وقد جرى التحقق من الأوامر أدناه باستخدام الإصدار 59.6.2 في هذا العمل.

1. 1

   حدّث CLI وتحقق من الإصدار

   نفّذ أمر التحديث الموثّق، ثم تأكد من أن الإصدار المثبّت هو 59.6.2 على الأقل.

   vercel upgrade
   vercel --version

2. 2

   اضبط المخصص الافتراضي

   يمنح هذا المثال كل عضو لا يملك ميزانية مستخدم مخصصة بدلًا شهريًا مستقلًا قدره $50. ولا يعني ذلك أن المجموعة كلها تتشارك $50.

   vercel ai-gateway budgets defaults set user --limit 50 --refresh-period monthly

3. 3

   امنح المستخدم كثيف الاستهلاك حدًا مخصصًا

   تحل الميزانية المخصصة محل الإعداد الافتراضي لذلك الشخص. وتقبل Vercel عنوان بريد إلكتروني أو اسم مستخدم أو معرّف مستخدم.

   vercel ai-gateway budgets set user lead@example.com --limit 150 --refresh-period monthly
   vercel ai-gateway budgets list

4. 4

   انقل المفاتيح المشتركة إلى الفريق

   افتح AI Gateway، وانتقل إلى API Keys، ثم عدّل كل مفتاح يخص عبء عمل مشتركًا أو موجّهًا للعملاء واضبط Spend attribution على Team. تُنسب المفاتيح الجديدة افتراضيًا إلى User، لذا اجعل هذه المراجعة جزءًا من إنشاء أي مفتاح إنتاج.

5. 5

   أضف التنبيهات حين يحتاج إليها شخص

   يمكن للميزانيات المخصصة إرسال رسائل بريد إلكتروني عند 50% و75% و100% من الحد. تكون التنبيهات معطلة افتراضيًا، ولا ترسل الميزانية الافتراضية تنبيهات؛ لذلك أضف ميزانية مخصصة عندما يحتاج شخص بعينه إلى رسائل تحذير قبل الإيقاف.

تُعاد تهيئة الميزانيات الشهرية في اليوم الأول من الشهر عند منتصف الليل بتوقيت UTC. وتُعاد تهيئة الميزانيات اليومية عند منتصف الليل بتوقيت UTC، والأسبوعية يوم الاثنين عند منتصف الليل بتوقيت UTC، بينما ينشئ none حدًا تراكميًا لا يُعاد ضبطه أبدًا.

اختبر مسار الإيقاف والاستئناف في بيئة staging

لم تُغيَّر أي ميزانية لفريق Vercel حي لأجل هذا المقال، لأن العمل لم يتضمن فريقًا ومفتاحًا قابلين للاستخدام المؤقت. لذا يبقى الاختبار الآمن مطلوبًا في بيئة staging لديكم. أما سلوك 402 ومدد انتشار التغييرات أدناه، فهي جزء من عقد Vercel الموثّق وليست معيار أداء على مستوى حساب جرى قياسه في هذا العمل.

استخدم عضوًا مخصصًا لبيئة staging ومفتاحًا منسوبًا إلى ذلك العضو. لا تُجرِ هذا الاختبار على مفتاح إنتاج.

1. 1

   ابدأ بإنفاق ظاهر

   استخدم vercel ai-gateway budgets list للتحقق من إنفاق عضو staging خلال الفترة الحالية. إذا كان الإنفاق يتجاوز بالفعل الحد الأدنى الموثّق البالغ $1، فيمكنك بلوغ الحد من دون توليد دولار واحد من حركة اختبار جديدة.

2. 2

   اخفض سقف مستخدم staging

   عند تعديل الميزانية، يظل الإنفاق المتراكم في الفترة الحالية محفوظًا. اضبط مستخدم staging على $1، ثم امنح التغيير وقتًا للانتشار.

   vercel ai-gateway budgets set user staging@example.com --limit 1 --refresh-period monthly

3. 3

   أرسل طلبًا واحدًا عبر مفتاح ذلك العضو

   صدّر مفتاح staging المنسوب إلى العضو باسم AI_GATEWAY_API_KEY، ثم استخدم صيغة طلب HTTP الخام التي توثّقها Vercel.

   curl https://ai-gateway.vercel.sh/v1/chat/completions \
     -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "openai/gpt-5.6-sol",
       "messages": [
         {
           "role": "user",
           "content": "Invent a new holiday and describe its traditions."
         }
       ]
     }'

   بعد تفعيل ميزانية المستخدم ونفادها، يُفترض أن يعيد الطلب استجابة HTTP 402 بنوع الخطأ quota_for_entity_exceeded. وإذا حملت استجابة 402 نوعًا مختلفًا، فقد تكون المشكلة في رصيد ائتمان الفريق لا في الميزانية.

4. 4

   ارفع الحد وأعد المحاولة

   ارفع الحد المخصص فوق قيمة الإنفاق التي يعرضها budgets list. وتستخدم صيغة الأمر الموثّقة هنا $100.

   vercel ai-gateway budgets set user staging@example.com --limit 100 --refresh-period monthly

   عادةً ما تنتشر تغييرات الميزانية خلال عشرات الثواني، لكنها قد تستغرق نحو خمس دقائق لمفتاح نشط. انتظر، ثم أرسل الطلب نفسه مرة أخرى. يُفترض أن يُستأنف ما لم تكن ميزانية أخرى منطبقة على المفتاح أو الفريق قد نَفِدت.

5. 5

   أعد السياسة المقصودة

   أعد مستخدم staging إلى الحد المخصص المخطط له. ولا تمثل إزالة الميزانية المخصصة مخرجًا مضمونًا دائمًا، لأن المستخدم يعود إلى الميزانية الافتراضية عند وجودها. وإذا كانت تلك الميزانية الافتراضية قد نَفِدت بالفعل، فستظل حركة المرور محظورة.

حدّان يسهل إغفالهما

أولًا، يقع إنفاق BYOK خارج جميع ميزانيات AI Gateway. فعندما تستخدم البوابة بيانات اعتماد المزوّد الخاصة بك، يُقاس ذلك الإنفاق بصورة منفصلة، ولا يستطيع سقف المستخدم احتواءه. كذلك قد يعود طلب BYOK الفاشل إلى بيانات اعتماد نظام Vercel، فتُخصم تكلفته من رصيد AI Gateway الخاص بالفريق.

ثانيًا، تتعارض صفحات Vercel الحالية بشأن app tokens. إذ يقول إصدار 31 أغسطس إن حدود المستخدم تشمل مفاتيح API المنسوبة إلى المستخدم إلى جانب app tokens. لكن وثائق Budgets الحالية تنص على أن app tokens لا تُسنَد إلى عضو، ولا تُحتسب أبدًا ضمن ميزانية المستخدم.

خطوة يوم الاثنين

تحرّك هذا الأسبوع إذا كان عدة أعضاء في الفريق يشغّلون وكلاء برمجة أو أحمالًا أخرى بلا إشراف عبر مفاتيح AI Gateway الخاصة بهم. وانتظر إذا كانت حركة المرور لديك تستخدم project OIDC tokens فقط أو بيانات اعتماد مزوّد BYOK، لأن ميزانيات المستخدمين لا تتحكم في تلك المسارات. أما المشغّل الفردي الذي لديه مفتاح واحد وميزانية فريق واحدة، فلن يتأثر كثيرًا.

يوم الاثنين، صنّف كل مفتاح في البوابة إلى PERSON أو SHARED. انقل مفاتيح الإنتاج المشتركة أولًا إلى إسناد Team. ثم اضبط ميزانية مستخدم شهرية افتراضية واحدة، وأضف فقط الاستثناءات المخصصة التي تستطيع المنشأة تبريرها، ونفّذ اختبار 402 في بيئة staging عبر الإيقاف ورفع الحد والاستئناف. لا تصبح الميزانية جاهزة إلا عندما يبقى الإنتاج خارج مخصص شخص واحد، ويعرف المشغّل أي حد أوقف الطلب.

لمزيد من الملاحظات العملية حول التحكّم في تكاليف الذكاء الاصطناعي وسير عمل الإنتاج، اشترك في النشرة البريدية.