يقدّم هذا الدليل نظرة عامة على خيارات الفوترة المختلفة لواجهة Gemini API، ويوضّح كيفية تفعيل الفوترة وتتبُّع الاستخدام، كما يقدّم إجابات عن الأسئلة الشائعة حول الفوترة.
لمحة عن الفوترة والمستويات
تستند الفوترة في Gemini API إلى سجلّ الدفع الخاص بك.
| فئة الاستخدام | التصفيات | الحد الأقصى لفئة الفوترة |
|---|---|---|
| Free | إشتراك | لا ينطبق |
| المستوى 1 | حساب الفوترة النشط | 250 دولار أمريكي |
| المستوى 2 | تم دفع 100 دولار أمريكي + 3 أيام من أول عملية دفع ناجحة | 2000 دولار أمريكي (أو ما يعادله بالعملة المحلية) |
| المستوى 3 | تم دفع 1,000 دولار أمريكي + 30 يومًا من أول عملية دفع ناجحة | $20,000 - $100,000+ |
تبدأ الحسابات الجديدة بالمستوى المجاني الذي يتيح الوصول إلى نماذج معيّنة في Gemini API وAI Studio، وذلك بما لا يتجاوز حدود معدّل الاستخدام للنماذج.
للحصول على حدود أعلى لعدد الطلبات في الدقيقة، واستخدام نماذج متقدّمة، وضمان عدم استخدام طلباتك وردودك لتحسين منتجات Google*، يمكنك ربط حساب فوترة للانتقال إلى المستويات المدفوعة. ستنتقل إلى مستويات أعلى استنادًا إلى الإنفاق التراكمي وعمر الحساب. يمكنك في أي وقت إلغاء ربط مفاتيح API الفردية لإعادة هذا المفتاح إلى حصة AI Studio المجانية.
* خصوصية البيانات على مستوى المؤسسة: لمزيد من المعلومات حول استخدام البيانات في الخدمات المدفوعة، يُرجى الاطّلاع على بنود الخدمة.
إعداد الفوترة للوصول إلى "المستوى المدفوع"
يمكنك إنشاء مشروع وإعداد الفوترة، أو استيراد مشروع حالي للترقية إلى "المستوى المدفوع" مباشرةً في 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 من خلال لوحة البيانات > الاستخدام.
حدود الإنفاق
تتيح Gemini API وضع حدود قصوى للإنفاق الشهري على مستوى كلّ من فئة حساب الفوترة والمشاريع. تم تصميم عناصر التحكّم هذه لحماية حسابك من التجاوزات غير المتوقعة، ولحماية النظام المتكامل لضمان توفّر الخدمة.
حدود الإنفاق على المشاريع
يمكنك ضبط حدود الإنفاق على مستوى المشروع في AI Studio. ويكون ذلك مفيدًا إذا كان لديك مشاريع متعددة ضمن حساب الفوترة نفسه وأردت التأكّد من أنّ كل مشروع لديه إذن الوصول إلى الحدّ الأقصى للإنفاق الكافي.
يمكن للحسابات التي لديها أدوار محرّر المشروع أو المالك أو المشرف تعيين حدود الإنفاق لكل مشروع في "استوديو الذكاء الاصطناعي" من خلال صفحة الإنفاق ضمن حد الإنفاق الشهري > تعديل حد الإنفاق.
في حال نقل مشروع إلى حساب فوترة مختلف، سيظلّ أي حدّ أقصى للإنفاق سبق أن حدّدته لهذا المشروع ساريًا، ولكن ستتم إعادة ضبط أي إنفاق متراكم إلى 0 دولار أمريكي لدورة الفوترة الجديدة.
قد يؤدي إكمال الوضع المجمّع إلى تكبّد رسوم إضافية.
قد تتأخر أوقات معالجة بيانات الفوترة قليلاً في AI Studio، لمدة تصل إلى 10 دقائق تقريبًا. قد تتجاوز التكاليف الحد الأقصى للمشروع إذا لم تتم معالجة بيانات الفوترة قبل تراكم المزيد من الرسوم.
حدود الإنفاق في فئة حساب الفوترة
يحتوي كل مستوى على حدّ أقصى للإنفاق الشهري:
| فئة الاستخدام | الحدّ الأقصى للإنفاق |
|---|---|
| Free | لا ينطبق |
| المستوى 1 | 250 دولار أمريكي |
| المستوى 2 | 2000 دولار أمريكي (أو ما يعادله بالعملة المحلية) |
| المستوى 3 | 20,000 - 100,000 دولار أمريكي |
يتم فرض حدود الاستخدام الشهرية على مستوى حساب الفوترة، وهي تكون مضبوطة مسبقًا ولا يمكن ضبطها. يتم تجميع إجمالي الإنفاق على مستوى جميع المشاريع المرتبطة، وعندما يصل الإجمالي التراكمي إلى الحد الأقصى للمستوى، يتم تعليق الخدمة لجميع المشاريع ضِمن هذا الحساب حتى بداية دورة الفوترة التالية (الشهرية).
يُرجى العِلم أنّ عددًا قليلاً من المستخدمين سيتأثّرون عند بدء تطبيق هذا التغيير في بداية شهر أبريل. إذا كان إنفاقك الحالي أعلى من الحدّ الأقصى الجديد الذي تم فرضه على المستوى، سيتم إشعارك عبر البريد الإلكتروني بمزيد من التفاصيل.
Cloud Billing
تستخدم واجهة Gemini API خدمة Cloud Billing لحسابات الفوترة، ويمكنك إعدادها مباشرةً في AI Studio. يمكنك استخدام AI Studio لتتبُّع الإنفاق وفهم التكاليف. يمكنك الوصول إلى المعلومات نفسها وإجراء الدفعات في حساب الفوترة على Cloud.
المشاريع ومفاتيح واجهة برمجة التطبيقات
يمكنك إنشاء ما يصل إلى 10 مشاريع ضمن حساب فوترة واحد، ويمكن ربط مشروع واحد بما يصل إلى 5 مفاتيح لواجهة برمجة التطبيقات.
تنطبق فئات الحصص على مستوى حساب الفوترة. تتضمّن جميع المشاريع ضِمن حساب فوترة فئة الحصة والحدود المرتبطة بها. يتم احتساب الإنفاق التراكمي وعمر الحساب في جميع المشاريع المرتبطة بحساب فوترة ضمن مؤهلات المستوى.
مفاتيح واجهة برمجة التطبيقات هي بيانات اعتماد يتم إنشاؤها داخل مشروع. ليس لديها إعدادات فوترة مستقلة، بل ترث حدود الفئة وحالة الفوترة الخاصة بالمشروع. يتم احتساب الاستخدام التراكمي من جميع المفاتيح ضِمن مشروع معيّن ضمن الحد الأقصى للإنفاق الخاص بهذا المشروع وإجمالي الإنفاق الخاص بحساب الفوترة.
الأسئلة الشائعة
تقدّم الأقسام التالية إجابات عن الأسئلة الشائعة.
ما هي الرسوم التي يتم تحصيلها مني؟
يستند تسعير 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.