إعادة شحن رصيد AI API تلقائياً: كيف تمنع خاصية Auto Recharge من TokenLab انقطاع الرصيد

يمكن لوكيل (agent) في بيئة الإنتاج أن يستهلك رصيداً كبيراً في دقائق، ويؤدي نفاد الرصيد إلى توقف كل طلب بشكل مفاجئ. ميزة Auto Recharge من TokenLab هي إعداد على مستوى المؤسسة قمنا ببنائه لمنع هذا النوع من الفشل: فهي تقوم بشراء المزيد من الرصيد عندما ينخفض رصيدك عن حد معين تقوم بتحديده. عند ضبطها بشكل جيد، سيستمر تشغيل حلقة الوكيل (agent loop)، أو مهمة الدفعة (batch job)، أو طفرة حركة المرور بدلاً من الاصطدام بحائط نفاد الرصيد. فيما يلي شرح لكيفية عمل منطق التشغيل، وما يحدث عند رفض البطاقة أثناء إعادة الشحن، والحدود الدنيا والقصوى الفعلية، وكيفية تفعيلها من لوحة تحكم الفواتير.

أبرز النقاط

• ميزة Auto Recharge اختيارية ويتم تكوينها لكل مؤسسة من لوحة تحكم الفواتير بواسطة مسؤول أو مالك المؤسسة. وهي ليست مفعلة افتراضياً.
• الإعدادات الافتراضية هي: مبلغ التشغيل 5 دولارات، ومبلغ الاستعادة 30 دولاراً، والحد الأقصى لإعادة الشحن الشهري 300 دولار. الحد الأدنى لأي مبلغ متعلق بإعادة الشحن هو 1 دولار، والحد الأقصى الشهري هو 10,000 دولار.
• عند فشل الدفع، لا نقوم بإعادة المحاولة بصمت. بل نقوم بتعطيل Auto Recharge، ووضع علامة payment_failed أو requires_action على المعاملة، وإرسال بريد إلكتروني يفيد بالفشل.
• لا توجد حالياً واجهة برمجة تطبيقات (API) عامة أو خطاف ويب (webhook) لتكوين أو مراقبة Auto Recharge. يتم التكوين في لوحة التحكم؛ وتتم المراقبة من خلال حالة لوحة التحكم، والبريد الإلكتروني، وسجل المعاملات.
• يُشترط وجود وسيلة دفع Stripe محفوظة قبل أن تتمكن من تفعيل Auto Recharge.

كيفية تفعيل Auto Recharge في TokenLab وتحديد عتباتك

1. سجّل الدخول كمسؤول أو مالك للمؤسسة وافتح لوحة تحكم الفواتير.
2. أضف وسيلة دفع إذا لم تقم بذلك بالفعل. لا يمكن تفعيل Auto Recharge بدون وجود وسيلة دفع Stripe محفوظة في الملف.
3. اضبط When balance drops below (مبلغ التشغيل). هذا هو مستوى الرصيد الذي يطلق عملية إعادة الشحن.
4. اضبط Restore balance to (مبلغ الاستعادة). يجب أن يكون أكبر من مبلغ التشغيل؛ وهو الرصيد الذي ستصل إليه بعد إعادة الشحن.
5. اضبط حداً أقصى لإعادة الشحن الشهري، أو اتركه مفعلاً مع مساحة كافية لتغطية دورة إعادة شحن واحدة على الأقل.
6. احفظ وتأكد من أن Auto Recharge نشط. ستعرض لوحة التحكم حالتها الحالية (نشطة، متوقفة مؤقتاً، أو معطلة).

إذا لم تقم بتخصيص هذه الحقول، تطبق TokenLab الإعدادات الافتراضية: التشغيل عند 5 دولارات، الاستعادة إلى 30 دولاراً، والحد الشهري 300 دولار. هذه الإعدادات الافتراضية تناسب مساحة عمل ذات حجم منخفض تختبر الـ API. وهي بالتأكيد منخفضة جداً لوكيل في بيئة الإنتاج أو روبوت محادثة يواجه العملاء. قم بتحديد أحجامها بناءً على مزيج النماذج الفعلي الخاص بك، وهو ما سنغطيه تالياً.

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

النموذج	المزود	الإدخال ($/MTok)	الإخراج ($/MTok)	نافذة السياق	المصدر	تاريخ الرصد
Claude Sonnet 5	Anthropic	$2.00	$10.00	1,000,000	لقطة أسعار TokenLab المباشرة	2026-07-09
GPT-5.5	OpenAI	$5.00	$30.00	1,050,000	لقطة أسعار TokenLab المباشرة	2026-07-09
Gemini 3.5 Flash	Google	$1.50	$9.00	1,048,576	لقطة أسعار TokenLab المباشرة	2026-07-09
DeepSeek V4 Flash	DeepSeek	$0.09	$0.18	1,048,576	لقطة أسعار TokenLab المباشرة	2026-07-09
GLM-5.2	Z.ai	$0.70	$2.20	1,048,576	لقطة أسعار TokenLab المباشرة	2026-07-09

إن خط أنابيب (pipeline) يعمل في الغالب على DeepSeek V4 Flash للصياغة مع GPT-5.5 للإخراج النهائي يستهلك الرصيد بمعدل مختلف تماماً عن خط يعمل بالكامل على GPT-5.5. على سبيل المثال، سيؤدي أسبوع مكثف بـ GPT-5.5 إلى إطلاق عمليات إعادة شحن أكثر بكثير من أسبوع مكثف بـ DeepSeek V4 Flash. كل عملية إعادة شحن تُحسب ضمن حدك الشهري. نوصي بالتحقق من مزيج استخدامك الفعلي قبل تثبيت العتبة. للحصول على مقارنة كاملة للأسعار عبر الكتالوج، راجع صفحة مقارنة الأسعار.

كيف يعمل منطق التشغيل فعلياً

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

يتم تخطي عملية التشغيل (عدم إطلاقها) في الحالات التالية:

• الرصيد الحالي أعلى بالفعل من مبلغ التشغيل.
• توجد عملية إعادة شحن تلقائية أخرى للمؤسسة معلقة بالفعل.
• قفل التشغيل (trigger lock) نشط (يمنع إطلاق عمليات إعادة شحن مكررة في التسويات المتتالية السريعة).
• لا توجد وسيلة دفع محفوظة في الحساب.
• إطلاق عملية إعادة الشحن هذه سيؤدي إلى تجاوز الحد الشهري لإعادة الشحن.

إذا تم تجاوز الحد الشهري، نقوم بإيقاف Auto Recharge مؤقتاً وتسجيل lastFailureCode: "monthly_limit_reached". هذا توقف متعمد، وليس خطأ برمجياً. إنه يحميك من الإنفاق الشهري الجامح إذا تم ضبط حدك الشهري على مستوى منخفض جداً بالنسبة لاستخدامك الفعلي. إذا رأيت هذه الحالة، ارفع حدك الشهري حتى سقف 10,000 دولار أو أعد التفعيل يدوياً بعد مراجعة سبب الوصول إلى الحد.

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

ماذا يحدث عند رفض بطاقتك أثناء إعادة شحن TokenLab التلقائية؟

هذا هو السؤال الذي يحدد ما إذا كنت تثق في Auto Recharge لاستمرارية عمل بيئة الإنتاج. تنفيذ الفواتير يجيب على ذلك مباشرة.

عند نجاح الدفع، نقوم بإضافة رصيد إلى رصيد مؤسستك مرة واحدة ونضع علامة "مكتملة" على المعاملة. نقوم بتخزين رابط الفاتورة أو الإيصال عند توفره، ونزيد إجمالي إنفاقك الشهري، ونبقي Auto Recharge نشطاً للمرة القادمة، ونرسل بريداً إلكترونياً بنجاح الدفع.

عند فشل الدفع أو الحاجة إلى إجراء من العميل (على سبيل المثال، التحقق عبر 3D Secure)، نضع علامة "فشل" على المعاملة. نقوم بتعطيل Auto Recharge، ونضبط الحالة على payment_failed أو requires_action، ونسجل تفاصيل الفشل، ونرسل بريداً إلكترونياً بفشل الدفع.

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

ما يعنيه هذا لإعدادك التشغيلي:

• تعامل مع البريد الإلكتروني الخاص بفشل الدفع كتنبيه قابل للتنفيذ، وليس كإشعار للتجاهل. هذا يعني أن Auto Recharge معطل الآن حتى تقوم بإصلاح وسيلة الدفع وإعادة تفعيلها من لوحة التحكم.
• حافظ على تحديث وسيلة الدفع المحفوظة. البطاقة منتهية الصلاحية هي السبب الأكثر احتمالاً لحالة payment_failed، ولا يوجد خيار احتياطي تلقائي لبطاقة ثانوية في هذا التنفيذ.
• إذا كانت استمرارية العمل (uptime) حاسمة، فلا تعتمد فقط على البريد الإلكتروني. قم ببناء فحص رصيد مستقل أدناه حتى لا يتحول بريد إلكتروني مفقود أو مفلتر إلى انقطاع غير مكتشف.

هل توجد واجهة برمجة تطبيقات (API) أو خطاف ويب (webhook) لـ Auto Recharge في TokenLab؟

ليس حالياً. تكوين Auto Recharge (مبلغ التشغيل، مبلغ الاستعادة، الحد الشهري، وسيلة الدفع) متاح فقط عبر لوحة التحكم لمسؤولي وملاك المؤسسة. لا توجد نقطة نهاية (endpoint) عامة موثقة لـ API لضبط هذه العتبات برمجياً، ولا يوجد خطاف ويب عام موثق يتم إطلاقه عند أحداث التشغيل أو النجاح أو الفشل.

أسطح المراقبة المتاحة للعملاء هي:

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

إذا كنت بحاجة إلى مراقبة برمجية لنظام إنتاج، فإن الحل العملي اليوم هو مهمة مجدولة تتحقق من رصيد مؤسستك من خلال أي وصول للقراءة المصرح به الذي توفره جلسة لوحة التحكم الخاصة بك. قم بتنبيه فريقك إذا انخفض الرصيد عن عتبة ثانية أقل من عتبة تشغيل Auto Recharge الخاصة بك. هذا يمنحك إشارة مستقلة حتى لو تم تعطيل Auto Recharge نفسها بعد فشل البطاقة. لا تقم ببناء كود تكامل مقابل نقطة نهاية مفترضة أو شكل حمولة (payload). إذا قامت TokenLab بتوثيق API للفواتير أو خطاف ويب، تحقق من العقد الدقيق في مرجع الـ API قبل ربطه في خط أنابيب التنبيهات.

الحدود الدنيا والقصوى والمبالغ الافتراضية

الحقل	الحد الأدنى	الحد الأقصى	الافتراضي	ملاحظات
مبلغ التشغيل (balance drops below)	$1	أقل من مبلغ الاستعادة	$5	يجب أن يظل أقل من مبلغ الاستعادة
مبلغ الاستعادة (restore balance to)	$1	مقيد بالحد الشهري	$30	يجب أن يكون أكبر من مبلغ التشغيل
الحد الشهري لإعادة الشحن	يجب أن يغطي دورة إعادة شحن واحدة	$10,000	$300	تتوقف عمليات إعادة الشحن مع monthly_limit_reached بمجرد الوصول لهذا الحد

المصدر: لوحة تحكم فواتير TokenLab وتنفيذ Auto Recharge، /dashboard/billing، تم الرصد في 2026-07-09.

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

من يجب عليه تفعيل هذه الميزة، وما الذي يجب التحقق منه قبل الاعتماد عليها

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

• الوكلاء المستقلون أو شبه المستقلين. حلقات الوكيل التي تعمل على نماذج مثل Claude Sonnet 5 أو Kimi K2.7 Code يمكن أن تستهلك الرصيد بشكل غير متساوٍ. على سبيل المثال، حلقة عالقة تستهلك الرصيد أسرع مما قد يلاحظه الإنسان.
• روبوتات المحادثة التي تواجه العملاء. تشهد روبوتات محادثة الدعم والمنتجات حركة مرور تتناسب مع استخدام منتجك الخاص. لا ينبغي أن تتحول طفرة في عطلة نهاية الأسبوع إلى انقطاع يوم الاثنين.
• أعباء عمل التوليد التي تعمل في طفرات. تتجمع مهام الصور والفيديو (Nano Banana Pro, Seedance, Veo 3) حول عمليات الإطلاق أو دفعات المحتوى. يمكن لجلسة عرض (rendering) واحدة أن تنفق أكثر من أسبوع معتاد.
• مهام الدفعات المجدولة. خطوط الأنابيب الليلية أو الأسبوعية هي بالضبط المكان الذي يكون فيه فشل الرصيد في منتصف التشغيل مكلفاً للتشخيص وإعادة التشغيل.

الخطوة	ما يجب التحقق منه	لماذا يهم
تأكيد أن وسيلة الدفع محدثة	البطاقة غير منتهية الصلاحية، تم التحقق منها في لوحة التحكم	لا يمكن إطلاق إعادة الشحن بدون وسيلة دفع محفوظة صالحة
ضبط مبلغ التشغيل فوق ذروة استهلاكك اليومي	اجعله بناءً على أكثر أيامك ازدحاماً، وليس متوسطك	إذا كان منخفضاً جداً، يمكن للطفرة استنزاف الرصيد قبل وصول مبلغ الاستعادة
ضبط مبلغ الاستعادة فوق الإنفاق الأسبوعي	استخدم جدول أسعار النماذج أعلاه للتقدير	أسبوع مكثف بـ GPT-5.5 يكلف أكثر بكثير من أسبوع مكثف بـ DeepSeek V4 Flash
ضبط الحد الشهري مع مساحة كافية	الافتراضي 300 دولار غالباً ما يكون منخفضاً جداً للإنتاج	الوصول للحد يوقف Auto Recharge مع monthly_limit_reached
التعامل مع رسائل فشل الدفع كتنبيهات	وجه رسائل فشل الدفع إلى قناة تحت الطلب (on-call)	Auto Recharge تعطل نفسها عند الفشل؛ لن يخبرك أي شيء آخر
إضافة مراقبة رصيد مستقلة	افحص الرصيد وفق جدول زمني خارج نطاق تشغيل Auto Recharge	لا يوجد خطاف ويب عام حالياً؛ لا تعتمد على الرؤية من لوحة التحكم فقط
مراجعة الاستخدام أسبوعياً	تحقق من الاستهلاك حسب النموذج وحسب المشروع	Auto Recharge تزيل مخاطر الانقطاع، وليس رؤية التكلفة

لمقارنات تكلفة النماذج لإبلاغ عتباتك، راجع صفحة مقارنة الأسعار. لنقل الطلبات غير الحرجة إلى نماذج أرخص مثل DeepSeek V4 Flash أو Gemini 3.5 Flash، راجع صفحة تصنيفات النماذج.

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

القيود والاعتبارات:

• هيكل الرسوم. ما إذا كانت فواتير Auto Recharge تحمل أي رسوم معالجة تتجاوز مبلغ الرصيد غير مؤكد في وثائق الفواتير المنشورة لـ TokenLab. تحقق من بنود فاتورة Stripe أو شروط الفواتير مباشرة.
• زمن انتقال المعالجة. الوقت بين إعادة الشحن المشغلة والرصيد الجديد الذي يظهر في حسابك لم يتم قياسه هنا. إذا كان لعبء العمل موعد نهائي صارم، اختبر بإعادة شحن يدوية أولاً وراقب توقيت لوحة التحكم قبل الاعتماد على Auto Recharge لطفرة حساسة للوقت.
• الوصول البرمجي. لا توجد API عامة أو خطاف ويب لتكوين أو أحداث Auto Recharge موثقة اليوم. إذا أضافت TokenLab واحدة، تحقق من نقطة النهاية الدقيقة والحمولة في مرجع الـ API الرسمي قبل البناء عليها.

الأسئلة الشائعة

هل يمكنني تكوين Auto Recharge في TokenLab باستخدام API؟

ليس حالياً. يتم تكوين Auto Recharge من خلال لوحة تحكم الفواتير بواسطة مسؤول أو مالك المؤسسة. لا توجد نقطة نهاية API عامة موثقة لضبط قيم التشغيل أو الاستعادة أو الحد الشهري برمجياً.

ما هي مبالغ التشغيل والاستعادة الافتراضية؟

الإعدادات الافتراضية هي: التشغيل عند 5 دولارات، والاستعادة إلى 30 دولاراً، والحد الشهري 300 دولار. الحد الأدنى للتشغيل والاستعادة والمبالغ ذات الصلة هو 1 دولار. الحد الأقصى لإعادة الشحن الشهري هو 10,000 دولار.

ماذا يحدث إذا تم رفض بطاقتي أثناء إعادة الشحن؟

نضع علامة "فشل" على المعاملة، ونعطل Auto Recharge، ونضبط الحالة على payment_failed أو requires_action، ونسجل تفاصيل الفشل، ونرسل بريداً إلكترونياً بفشل الدفع. نحن لا نعيد المحاولة بصمت.

هل تعيد TokenLab Auto Recharge المحاولة بعد فشل الدفع؟

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

هل ميزة TokenLab Auto Recharge مفعلة افتراضياً؟

لا. إنها اختيارية لكل مؤسسة وتتطلب وسيلة دفع محفوظة قبل أن يمكن تفعيلها.

قم بتكوين Auto Recharge من لوحة تحكم الفواتير، أو قارن أسعار النماذج أولاً في صفحة النماذج لتحديد عتباتك بشكل صحيح.