TokenLab Management API تضيف ميزة الاستعلام عن رصيد المؤسسة

يدعم الآن Management API الخاص بـ TokenLab الاستعلام المباشر عن الرصيد، مما يتيح للفرق إمكانية التحقق من إجمالي رصيد مؤسستهم الحالي من خلال رمز إدارة (management token) بدلاً من التحقق من لوحة التحكم يدوياً. يسد هذا التحديث فجوة شائعة لدى الفرق التي تدير عمليات التحقق التلقائي من الميزانية، أو تنبيهات إعادة الشحن، أو سير العمل المقيد بالاستخدام.

أبرز النقاط

• يوفر Management API الآن نقطة نهاية (endpoint) للرصيد تعيد إجمالي الرصيد الحالي لمؤسستك.
• تنفصل هذه الميزة عن مفاتيح API الخاصة باستنتاج النماذج (model inference API keys) المستخدمة لاستدعاء Claude Sonnet 5 وGPT-5.5 وGemini 3.5 Flash ونماذج أخرى.
• يهدف الاستعلام عن الرصيد إلى التحقق من الميزانية، وتنبيهات إعادة الشحن، وإيقاف أو استئناف سير العمل التلقائي، وتغذية لوحات بيانات الشؤون المالية.
• تتكامل نقطة النهاية هذه بشكل جيد مع نقطة نهاية استخدام مفتاح API الحالية لبناء صورة كاملة عن الإنفاق.

لماذا كانت هذه الميزة مفقودة؟

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

غالباً ما ترغب الفرق التي تدير أعباء عمل إنتاجية عبر نماذج مثل DeepSeek V4 Pro أو Qwen3.7 Plus أو Kimi K2.7 Code في الحصول على برنامج نصي يتحقق من الرصيد قبل بدء مهمة كبيرة، أو نظام مراقبة يطلق تنبيهاً عندما ينخفض الرصيد عن حد معين. بدون نقطة نهاية قابلة للاستعلام عن الرصيد، كانت الخيارات الوحيدة هي الفحص اليدوي أو كشط لوحة التحكم، وكلاهما ليس أمراً ترغب في تشغيله في بيئة الإنتاج.

يعالج الاستعلام عن الرصيد من خلال Management API هذه المشكلة. الآن، يمكن لنفس الأتمتة التي تطلق مجموعة من مهام إنشاء الفيديو على Kling 3.0 أو Seedance التحقق من الرصيد المتاح أولاً واتخاذ قرار بشأن المضي قدماً.

رموز الإدارة (Management Tokens) مقابل مفاتيح API لاستنتاج النماذج

من المهم توضيح هذا الأمر، لأن نوعي بيانات الاعتماد يخدمان أغراضاً مختلفة والخلط بينهما يؤدي إلى أخطاء محيرة.

مفاتيح API لاستنتاج النماذج هي ما تستخدمه لاستدعاء النماذج مباشرة. إذا كنت ترسل طلب إكمال محادثة إلى GPT-5.5، أو تنشئ صورة باستخدام GPT Image 2 أو Nano Banana Pro، أو تعرض فيديو باستخدام Veo 3 أو PixVerse V6، فأنت تقوم بالمصادقة باستخدام مفتاح استنتاج. تقتصر هذه المفاتيح على إجراء استدعاءات النماذج وإرجاع مخرجات النموذج. وهي لا تمنحك حق الوصول إلى بيانات مستوى الحساب مثل الرصيد أو ملخصات الاستخدام.

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

يعد الحفاظ على فصل هذه الرموز أمراً مهماً لسبب عملي: فهو يسمح لك بتسليم رمز إدارة إلى عملية مالية أو تشغيلية دون منح تلك العملية القدرة على استهلاك ميزانية النماذج الخاصة بك. وعلى العكس من ذلك، فإن الخدمة التي تحتاج فقط إلى استدعاء GLM-5.2 أو DeepSeek V4 Flash لا تحتاج إلى أي رؤية لرصيدك أو سجل إنفاقك، لذا يجب أن تحمل فقط مفتاح استنتاج.

كيف يعمل الاستعلام عن الرصيد

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

إليك مثال بسيط باستخدام قيم نائبة:

curl -s https://api.tokenlab.sh/v1/management/balance \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN"

تمنحك الاستجابة رقم الرصيد الحالي لمؤسستك. ومن هناك، النمط المعتاد هو:

1. استدعاء نقطة نهاية الرصيد وفق جدول زمني، أو قبل بدء مهمة مكلفة.
2. مقارنة القيمة المرجعة بحد تحدده أنت.
3. إطلاق أي إجراء منطقي: إرسال تنبيه، إيقاف قائمة انتظار، حظر إرسال مهام جديدة، أو مجرد تسجيل البيانات لاستخدامها لاحقاً.

نظراً لأن هذه عملية قراءة بسيطة، فإن استدعاءها بشكل متكرر غير مكلف. يمكن للفرق التي تدير خطوط معالجة ذات حجم كبير مقابل نماذج مثل DeepSeek V4 Pro أو Claude Sonnet 5 التحقق من الرصيد قبل كل دفعة كبيرة دون إضافة عبء كبير.

توجد تفاصيل نقطة النهاية الكاملة في مرجع رصيد Management API.

أين يتناسب هذا: التحقق من الميزانية، التنبيهات، ولوحات البيانات

تتوافق الاستخدامات الأكثر شيوعاً التي طلبتها الفرق مع أربعة سيناريوهات:

حالة الاستخدام	كيف تبدو
التحقق من الميزانية قبل المهمة	يقوم البرنامج النصي بالتحقق من الرصيد قبل إرسال مهمة دفعية كبيرة إلى نموذج مثل Kling 3.0 أو Veo 3، ويتخطى المهمة إذا كان الرصيد منخفضاً جداً
تنبيه إعادة الشحن	يقوم فحص مجدول بمقارنة الرصيد بقيمة دنيا، ويرسل تنبيهاً عبر Slack أو البريد الإلكتروني عند تجاوزها
إيقاف واستئناف سير العمل	تقوم الأتمتة بإيقاف خط معالجة يستدعي Qwen3.7 Plus أو GLM-5.2 عند انخفاض الرصيد، وتستأنف العمل بمجرد إعادة الشحن
لوحات البيانات المالية	يتم سحب رقم الرصيد وفق جدول زمني وعرضه جنباً إلى جنب مع بيانات الاستخدام لإعداد التقارير

إذا كنت تقوم بإعداد هذا لأول مرة، فإن قائمة مرجعية قصيرة تساعد في الحفاظ على نظافة التنفيذ:

• إنشاء أو تأكيد أن رمز الإدارة الخاص بك لديه النطاق الصحيح للوصول إلى الرصيد
• تخزين رمز الإدارة بشكل منفصل عن أي مفاتيح API للاستنتاج
• تعيين فترة استطلاع معقولة (مرة واحدة لكل مهمة، أو كل ساعة، أو يومياً، حسب حالة الاستخدام الخاصة بك)
• تحديد حد التنبيه الخاص بك مسبقاً، وليس بعد انخفاض الرصيد
• إقران الاستعلام عن الرصيد بـ نقطة نهاية استخدام مفتاح API إذا كنت تريد تفصيلاً كاملاً للإنفاق بجانب رقم الرصيد

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

البدء

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

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

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

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

هل هذا هو نفسه نقطة نهاية الاستخدام؟ لا. تعيد نقطة نهاية الاستعلام عن الرصيد إجمالي رصيدك الحالي. تعيد نقطة نهاية استخدام مفتاح API بيانات الاستخدام مقسمة حسب المفتاح. تستخدم معظم لوحات البيانات المالية كليهما معاً.

المصادر والحداثة

يعكس هذا المقال نقطة نهاية رصيد Management API كما لوحظت في 2026-07-07. قد يتغير سلوك نقطة النهاية وتنسيقات الاستجابة؛ تحقق من وثائق نقطة نهاية الرصيد الرسمية للحصول على المرجع الحالي.

---

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

قراءة ذات صلة والخطوة التالية

يعمل الاستعلام عن رصيد المؤسسة جنباً إلى جنب مع أدوات إعداد التقارير الأخرى المتاحة بالفعل في TokenLab Management API. للحصول على نظرة فاحصة على كيفية سحب بيانات الإنفاق ومراجعتها بشكل منتظم، راجع صادرات استخدام TokenLab تجعل إنفاق API الذكاء الاصطناعي أسهل في المراجعة. إذا كنت تخطط للإنفاق قبل الإطلاق، فإن دليل حاسبة تكلفة AI API: تقدير الإنفاق قبل الشحن يستعرض تقدير التكاليف قبل إرسال الطلبات. وللحصول على سياق حول كيفية مقارنة الموفرين ببعضهم البعض، فإن مقارنة أسعار AI API 2026: التكلفة الحقيقية لـ GPT-5.5 وClaude Sonnet 5 وGemini 3.5 Flash توضح الأسعار الحالية عبر النماذج الرئيسية.

كما هو الحال دائماً، تتغير توفر النماذج والأسعار بشكل متكرر، لذا تأكد من التفاصيل الحالية قبل الاعتماد عليها للاستخدام الإنتاجي عالي الحجم. هل أنت مستعد لتجربة الاستعلام عن الرصيد بنفسك؟ أنشئ مفتاح API وابدأ في اختباره اليوم.