يوفّر هذا الدليل نظرة عامة حول خيارات الفوترة المختلفة لواجهة برمجة التطبيقات Gemini API، ويوضّح كيفية تفعيل الفوترة ومراقبة الاستخدام، ويقدّم إجابات عن الأسئلة الشائعة حول الفوترة.
لمحة عن الفوترة
تستند الفوترة لواجهة Gemini API إلى فئتَي تسعير: بدون أي تكلفة (أو مجاني) والدفع حسب الاستخدام (أو مدفوع). تختلف الأسعار وحدود الأسعار بين هذه الفئات، كما تختلف حسب الطراز. يمكنك الاطّلاع على صفحتَي الحدود القصوى للأسعار والأسعار للحصول على مزيد من المعلومات. للاطّلاع على تفاصيل الإمكانات لكل طراز على حدة، يُرجى الاطّلاع على صفحة طُرز Gemini.
كيفية طلب ترقية
تستخدم واجهة برمجة التطبيقات Gemini API خدمة "الفوترة في السحابة الإلكترونية" لجميع خدمات الفوترة. للانتقال من الفئة المجانية إلى فئة مدفوعة، عليك أولاً تفعيل ميزة "الفوترة في السحابة الإلكترونية" لمشروعك على Google Cloud.
عندما يستوفي مشروعك المعايير المحدّدة، يصبح مؤهّلاً للقيام بأحد الإجراءَين التاليَين: الترقية إلى المستوى التالي أو لطلب ترقية، اتّبِع الخطوات التالية:
- انتقِل إلى صفحة مفاتيح واجهة برمجة التطبيقات في AI Studio.
- ابحث عن المشروع الذي تريد ترقيته وانقر على ترقية.
- سيتحقّق النظام تلقائيًا من أهلية مشروعك. تستغرق هذه العملية بضع ثوانٍ.
- إذا كان مشروعك يستوفي جميع المتطلبات، سيتم ترقيته على الفور إلى المستوى التالي.
ما هي مزايا استخدام الفئة المدفوعة؟
عند تفعيل الفوترة واستخدام الفئة المدفوعة، يمكنك الاستفادة من حدود أعلى لأسعار الصرف، ولا يتم استخدام طلباتك وردودك لتحسين منتجات Google. لمزيد من المعلومات حول استخدام البيانات في الخدمات المدفوعة، يُرجى الاطّلاع على بنود الخدمة.
Cloud Billing
تستخدِم واجهة برمجة التطبيقات Gemini API Cloud Billing لخدمات الفوترة. لاستخدام الفئة المدفوعة، عليك إعداد "الفوترة في Google Cloud" على مشروعك على السحابة الإلكترونية. بعد تفعيل "الفوترة في Google Cloud"، يمكنك استخدام أدوات "الفوترة في Google Cloud" لتتبُّع الإنفاق ومعرفة التكاليف وإجراء الدفعات والوصول إلى فريق دعم "الفوترة في Google Cloud".
تفعيل الفوترة
يمكنك تفعيل ميزة "الفوترة في Google Cloud" من Google AI Studio باتّباع الخطوات التالية:
افتح Google AI Studio.
في أسفل الشريط الجانبي الأيمن، اختَر الإعدادات > معلومات الخطة.
انقر على إعداد الفوترة للمشروع الذي اخترته لتفعيل ميزة "الفوترة في السحابة الإلكترونية".
مراقبة الاستخدام
بعد تفعيل ميزة "الفوترة في السحابة الإلكترونية"، يمكنك تتبُّع استخدامك لواجهة برمجة التطبيقات Gemini API في
وحدة تحكُّم Google Cloud.
اسم الخدمة لواجهة برمجة التطبيقات هو generativelanguage.googleapis.com، وفي
وحدة التحكّم، يُشار إلى Gemini API أيضًا باسم Generative Language API.
لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Google Cloud حول مراقبة استخدام واجهة برمجة التطبيقات.
الأسئلة الشائعة
يقدّم هذا القسم إجابات عن الأسئلة الشائعة.
ما هي الرسوم التي يتم تحصيلها مني؟
يستند تسعير Gemini API إلى ما يلي:
- إدخال عدد الرموز المميّزة
- عدد الرموز المميّزة للإخراج
- عدد الرموز المميّزة المخزّنة مؤقتًا
- مدة تخزين الرمز المميّز في ذاكرة التخزين المؤقت
للاطّلاع على معلومات عن الأسعار، يُرجى الانتقال إلى صفحة الأسعار.
أين يمكنني الاطّلاع على حصتي؟
يمكنك الاطّلاع على الحصة وحدود النظام في Google Cloud Console.
كيف يمكنني طلب حصة أكبر؟
لطلب المزيد من الحصص، اتّبِع التعليمات الواردة في مقالة كيفية طلب ترقية.
هل يمكنني استخدام واجهة برمجة التطبيقات Gemini API مجانًا في المنطقة الاقتصادية الأوروبية (بما في ذلك الاتحاد الأوروبي) والمملكة المتحدة وسويسرا؟
نعم، تتوفّر الفئة المجانية والفئة المدفوعة في العديد من المناطق.
إذا أعددت الفوترة باستخدام Gemini API، هل سيتم تحصيل رسوم منّي مقابل استخدام Google AI Studio؟
لا، سيظل استخدام Google AI Studio مجانيًا بغض النظر عمّا إذا كنت قد أعددت ميزة الفوترة في جميع المناطق التي يتوفّر فيها التطبيق.
هل يمكنني استخدام مليون رمز مميّز في الفئة المجانية؟
تختلف الفئة المجانية لواجهة برمجة التطبيقات Gemini API استنادًا إلى النموذج المحدّد. في الوقت الحالي، يمكنك تجربة ميزة "مليون رمز مميّز يستنِد إلى السياق" بالطُرق التالية:
- في Google AI Studio
- مع خطط الدفع حسب الاستخدام
- مع خطط مجانية لطُرز محدّدة
يمكنك الاطّلاع على أحدث حدود الأسعار المجانية لكل نموذج في صفحة حدود الأسعار.
كيف يمكنني احتساب عدد الرموز المميّزة التي أستخدمها؟
استخدِم الأسلوب
GenerativeModel.count_tokens
لاحتساب عدد الرموز المميّزة. راجِع دليل الرموز المميّزة للاطّلاع على مزيد من المعلومات حول الرموز المميّزة.
هل يمكنني استخدام أرصدة Google Cloud مع Gemini API؟
نعم، يمكن استخدام أرصدة Google Cloud في استخدام Gemini API.
كيف يتم التعامل مع الفوترة؟
يعالج نظام Cloud Billing فواتير Gemini API.
هل يتم تحصيل رسوم منّي مقابل الطلبات التي تعذّر تنفيذها؟
إذا تعذّر إرسال طلبك بسبب خطأ 400 أو 500، لن يتم تحصيل رسوم منك مقابل الرموز المميّزة المستخدَمة. ومع ذلك، سيظلّ الطلب مُحتسَبًا ضمن حصتك.
هل يتم تحصيل رسوم مقابل تحسين النماذج؟
إنّ ضبط النموذج مجاني، ولكن يتم تحصيل رسوم الاستنتاج من نماذج الضبط بالسعر نفسه المستخدَم في النماذج الأساسية.
هل يتم تحصيل رسوم من GetTokens؟
لا يتم تحصيل رسوم من الطلبات المرسَلة إلى واجهة برمجة التطبيقات GetTokens API، ولا يتم احتسابها ضمن حصة الاستنتاج.
كيف تتم معالجة بياناتي في Google AI Studio إذا كان لديّ حساب مدفوع لواجهة برمجة التطبيقات؟
يُرجى الرجوع إلى البنود لمعرفة تفاصيل عن كيفية معالجة البيانات عند تفعيل ميزة الفوترة في Cloud (اطّلِع على "كيفية استخدام Google لبياناتك" ضمن "الخدمات المدفوعة"). يُرجى العِلم أنّ طلبات Google AI Studio تخضع لأحكام "الخدمات المدفوعة" نفسها ما دام قد تم تفعيل الفوترة في مشروع واحد على الأقل من مشاريع واجهات برمجة التطبيقات، ويمكنك التحقّق من ذلك في صفحة مفتاح Gemini API إذا ظهرت لك أي مشاريع مصنّفة على أنّها "مدفوعة" ضمن "الخطة".
أين يمكنني الحصول على مساعدة بشأن الفوترة؟
للحصول على مساعدة بشأن الفوترة، يُرجى الاطّلاع على مقالة الحصول على دعم بشأن "الفوترة في Cloud".