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