يوفّر هذا الدليل نظرة عامة حول خيارات الفوترة المختلفة لواجهة برمجة التطبيقات Gemini API، ويشرح كيفية تفعيل الفوترة ومراقبة الاستخدام، ويقدّم إجابات عن الأسئلة الشائعة حول الفوترة.
لمحة عن الفوترة
تستند الفوترة لواجهة Gemini API إلى فئتَي تسعير: بدون أي تكلفة (أو مجاني) والدفع حسب الاستخدام (أو مدفوع). تختلف الأسعار وحدود الأسعار بين هذه الفئات، كما تختلف حسب الطراز. يمكنك الاطّلاع على صفحتَي حدود الأسعار والأسعار للحصول على مزيد من المعلومات. للاطّلاع على تفاصيل الإمكانات لكل طراز على حدة، يُرجى الاطّلاع على صفحة طُرز Gemini.
كيفية طلب ترقية
للانتقال من المستوى المجاني إلى خطة الدفع حسب الاستخدام، عليك تفعيل الفوترة لمشروعك على Google Cloud. يعتمد الزر الذي يظهر لك في Google AI Studio على خطة مشروعك الحالية.
- إذا كنت تستخدم المستوى المجاني، سيظهر لك زر إعداد الفوترة لمشروعك.
- إذا كنت مشتركًا في الفئة المدفوعة وتستوفي معايير تغيير الخطة، قد يظهر لك الزر ترقية.
لبدء العملية، يُرجى اتّباع الخطوات التالية:
- انتقِل إلى صفحة مفاتيح واجهة برمجة التطبيقات في AI Studio.
- ابحث عن المشروع الذي تريد نقله إلى الخطة المدفوعة وانقر على إعداد الفوترة أو الترقية، حسب الزر المعروض.
- تعتمد الخطوة التالية على الزر الذي نقرت عليه:
- إذا نقرت على "إعداد الفوترة": ستتم إعادة توجيهك إلىconsole Google Cloud لربط حساب فوترة بمشروعك. اتّبِع التعليمات الظاهرة على الشاشة لإكمال العملية.
- في حال النقر على "ترقية": سيتحقّق النظام تلقائيًا من أهلية مشروعك. إذا كان مشروعك يستوفي كل المتطلبات، ستتم ترقيته على الفور إلى المستوى التالي.
ما هي مزايا استخدام الفئة المدفوعة؟
عند تفعيل الفوترة واستخدام الفئة المدفوعة، يمكنك الاستفادة من حدود أعلى لأسعار الصرف، ولا يتم استخدام طلباتك وردودك لتحسين منتجات Google. لمزيد من المعلومات حول استخدام البيانات في الخدمات المدفوعة، يُرجى الاطّلاع على بنود الخدمة.
Cloud Billing
تستخدم واجهة برمجة التطبيقات Gemini API Cloud Billing لخدمات الفوترة. لاستخدام الفئة المدفوعة، عليك إعداد "الفوترة في Google Cloud" على مشروعك على السحابة الإلكترونية. بعد تفعيل "الفوترة في Cloud"، يمكنك استخدام أدوات "الفوترة في Cloud" لتتبُّع الإنفاق وفهم التكاليف وإجراء الدفعات والوصول إلى فريق دعم "الفوترة في 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".