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