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