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