يقدّم هذا الدليل نظرة عامة على خيارات الفوترة المختلفة في Gemini API، ويوضّح كيفية تفعيل الفوترة وتتبُّع الاستخدام، ويقدّم إجابات عن الأسئلة الشائعة حول الفوترة.
لمحة عن الفوترة والمستويات
تستند الفوترة في Gemini API إلى سجلّ الدفع الخاص بك.
| فئة الاستخدام | التصفيات | الحد الأقصى لفئة الفوترة |
|---|---|---|
| Free | مشروع نشط أو فترة تجريبية مجانية | لا ينطبق |
| المستوى 1 | إعداد حساب فوترة نشط وربطه | 250 دولار أمريكي |
| المستوى 2 | تم دفع 100 دولار أمريكي + 3 أيام من أول عملية دفع ناجحة | $2,000 |
| المستوى 3 | تم دفع 1,000 دولار أمريكي + 30 يومًا من أول عملية دفع ناجحة | 20,000 دولار أمريكي - 100,000 دولار أمريكي أو أكثر |
تبدأ الحسابات الجديدة بالمستوى المجاني الذي يتيح الوصول إلى نماذج معيّنة في Gemini API وAI Studio، وذلك بما لا يتجاوز حدود معدّل المستوى المجاني للنماذج.
لنشر تطبيقاتك مباشرةً من "وضع الإنشاء"، يمكنك استخدام المستوى التمهيدي من Google Cloud. تتيح لك هذه الفئة نشر ما يصل إلى تطبيقَين كاملَين بدون الحاجة إلى إعداد مشروع على Google Cloud أو حساب فوترة. لمزيد من التفاصيل، يُرجى الاطّلاع على النشر من Google AI Studio، كما يمكنك الرجوع إلى مستندات "مستوى المبتدئين" في Google Cloud.
للوصول إلى حدود معدّل استخدام أعلى، واستخدام نماذج متقدّمة، وضمان عدم استخدام طلباتك وردودك لتحسين منتجات Google*، يمكنك ربط حساب فوترة والدفع المسبق للانتقال إلى الفئات المدفوعة. بعد ذلك، ستنتقل إلى مستويات أعلى استنادًا إلى الإنفاق التراكمي وعمر الحساب.
يتم تحديد الفئات وحدود المعدّل القصوى وحدود حساب الفوترة على مستوى حساب الفوترة.
* خصوصية البيانات على مستوى المؤسسة: لمزيد من المعلومات حول استخدام البيانات في الخدمات المدفوعة، يُرجى الاطّلاع على بنود الخدمة.
إعداد الفوترة للوصول إلى "الفئة المدفوعة"
يمكنك إنشاء مشروع وإعداد الفوترة أو استيراد مشروع حالي للترقية إلى "المستوى المدفوع" في Google AI Studio. يعني الترقية من "المستوى المجاني" إلى "المستوى المدفوع" ربط حساب فوترة والدفع المسبق لإضافة 5 دولارات أمريكية على الأقل (أو ما يعادله بالعملات الأخرى) من الرصيد إلى حسابك.
- انتقِل إلى صفحة مفاتيح واجهة برمجة التطبيقات أو صفحة المشاريع في AI Studio، أو إلى أي مكان يظهر فيه زر إعداد الفوترة في AI Studio.
- سيتم تلقائيًا إنشاء مشروع ومفتاح واجهة برمجة تطبيقات للمستخدمين الجدد.
- إذا كنت بحاجة إلى مفتاح جديد، انقر على إنشاء مفتاح واجهة برمجة تطبيقات واتّبِع التعليمات الواردة في مربّع الحوار لإضافة زوج من المفتاح والمشروع إلى الجدول.
- ابحث عن مشروع "المستوى المجاني" الذي تريد ترقيته إلى "المستوى المدفوع"، وانقر على إعداد الفوترة ضمن عمود مستوى الفوترة.
- إذا لم يسبق لك إعداد حساب فوترة على Google:
- سيُطلب منك اختيار بلدك للموافقة على بنود الخدمة.
- بعد ذلك، املأ معلومات الاتصال وطريقة الدفع أو أكِّدهما للمتابعة.
- إذا سبق لك إعداد حسابات فوترة على Google:
- سيُطلب منك الاختيار من بين حسابات الفوترة الحالية.
- إذا كنت لا تريد استخدام أي من حساباتك الحالية، انقر على إضافة حساب فوترة جديد وأدخِل معلومات الاتصال وطريقة الدفع أو أكِّدهما للمتابعة.
- بعد ذلك، سيتم إما:
- يُطلب منك الدفع المسبق بحد أدنى 5 دولارات أمريكية لإكمال عملية إعداد الفوترة (ما يعني أنّه يتم تلقائيًا تعيين حسابك إلى خطة الفوترة الدفع المسبق)،
- يجب أن يكون لديك خيار بين خطّتَي الفوترة الدفع المسبق والدفع عند الاستخدام لحسابك.
- تم تعيينها إلى خطة فوترة الدفع الآجل لفترة وسيطة إلى أن يتم نشر نظام الدفع المسبق الجديد لجميع المستخدمين (بدءًا من 23 مارس 2026).
- بعد الدفع المسبق أو اختيار "الدفع عند الاستخدام"، يكتمل إعداد حسابك.
الترقية إلى فئة الاشتراك المدفوع التالية
إذا كنت مشتركًا في فئة مدفوعة وتستوفي المعايير لتغيير الخطة، ستتم ترقيتك تلقائيًا إلى الفئة التالية (مع مراعاة أوقات المعالجة).
التحقّق من حالة الفوترة
بعد ربط حساب فوترة بمشروعك، يمكنك تتبُّع حالته في صفحة الفوترة في AI Studio. على عكس الخطة المجانية، تتغيّر حالة الخطة المدفوعة بشكل ديناميكي. ففي حين يتم تحديد درجة الاستخدام حسب سجلّ حسابك، لن تستجيب واجهة Gemini API للطلبات إلا إذا كان لديك رصيد مدفوع مسبقًا إيجابي.
في صفحة المشاريع، يمكنك الاطّلاع على مستوى مشروعك وخطة الفوترة ضِمن عمود مستوى الفوترة. تظهر أي إجراءات متعلقة بحالة الفوترة يجب اتّخاذها لأحد المشاريع في عمودَي فئة الفوترة أو الحالة:
- إعداد الفوترة إذا لم يكن المشروع مرتبطًا بحساب فوترة
- إعداد الدفع المسبق إذا كان المشروع يتضمّن حساب فوترة مرتبطًا به، ولكن يجب استخدام خطة فوترة الدفع المسبق التي يجب إعدادها.
- "لا تتوفّر أرصدة" إذا كان حساب الفوترة مطلوبًا لشراء أرصدة، ولكن لم يتم إعداد حساب الدفعات المسبقة أو تم استنفاد رصيد الأرصدة المتاح.
انقر على أي من الرسائل للمتابعة واتّخاذ الإجراءات اللازمة.
مراقبة الاستخدام
يمكنك تتبُّع استخدامك لواجهة Gemini API في Google AI Studio من خلال لوحة البيانات > الاستخدام.
خطط الفوترة
تنقسم خطط الفوترة الخاصة بواجهة Gemini API وAI Studio إلى فئتَين تحدّدان وقت الدفع مقابل الاستخدام: الدفع المسبق والدفع الآجل. يمكنك الاطّلاع على خطة الفوترة المحدّدة وإدارة طرق الدفع في صفحة فوترة AI Studio.
الدفع المسبق
في خطة الفوترة المسبقة الدفع، يمكنك شراء أرصدة لتعبئة رصيد الدفع المسبق قبل استخدامك لواجهة Gemini API، ويتم خصم تكاليف استخدام واجهة برمجة التطبيقات من رصيد الدفع المسبق في الوقت الفعلي تقريبًا. يمكنك إجراء الدفع المسبق من خلال إضافة رصيد إلى حسابك أو إعداد ميزة تعبئة الرصيد تلقائيًا. بعد شراء الأرصدة، تنتهي صلاحية الأرصدة غير المستخدَمة بعد 12 شهرًا، وهي غير قابلة للاسترداد، إلا بعد التبديل إلى حساب الدفع الآجل.
عندما يصل رصيد بطاقة الدفع المُسبَق في حساب الفوترة إلى 0 دولار أمريكي، ستتوقّف جميع مفاتيح واجهة برمجة التطبيقات في جميع المشاريع المرتبطة بحساب الفوترة هذا عن العمل في الوقت نفسه. لا تنطبق الأرصدة المدفوعة مسبقًا إلا على تكاليف استخدام Gemini API، ولا يمكنك استخدامها للدفع مقابل خدمات Google Cloud الأخرى.
يتم تلقائيًا ضبط خطة الفوترة على "الدفع المسبق" للمستخدمين الجدد. قد تحتاج المشاريع التي تم إنشاؤها قبل طرح خطتَي الفوترة "الدفع المسبق" و"الدفع الآجل" إلى تعديل تفاصيل الفوترة الخاصة بالمشروع قبل مواصلة استخدام Gemini API.
يُرجى العِلم أنّ خيار "الدفع المسبق" غير متاح للحسابات التي يتم إرسال الفواتير إليها (أو الحسابات غير المتصلة بالإنترنت).
إضافة الدفع المسبق إلى حساب الدفع عند الاستخدام حالي
إذا كان حساب الفوترة الحالي في Cloud يستخدم خطة الدفع عند الاستخدام، يمكنك إضافة إمكانات الدفع المُسبَق لشراء الرصيد مسبقًا. تتيح لك أرصدة الدفع المسبق هذه استخدام Gemini API بدون إنشاء حساب فوترة جديد على Cloud.
أثناء إعداد إضافة Prepay إلى حساب موجود، ستظهر لك شاشة تأكيد إلزامية توضح أنه سيتم تعديل حساب الفوترة السحابية الذي اخترته.
يجب أن يعدّل النظام حالة حسابك قبل إرسال الدفعة المسبقة. لذلك، قد يؤدي إلغاء العملية بعد تأكيد التعديل ولكن قبل إكمال إعداد الدفع المسبق إلى حدوث انقطاعات مؤقتة في الخدمة للمشاريع المرتبطة مسبقًا بحساب الفوترة في Cloud هذا. تأكَّد من أنّك مستعد لإكمال عملية الدفع المسبق قبل تأكيد الانتقال. في حال مواجهة مشاكل، يُرجى الاطّلاع على تعطُّل الخدمات بعد إلغاء عملية إعداد الدفع المسبق.
إذا كنت مؤهَّلاً وانتقلت يدويًا من دورة الدفع المسبق إلى دورة الدفع عند الاستخدام، سيتم تلقائيًا ردّ أي رصيد متبقٍّ من الدفع المسبق إلى طريقة الدفع الأصلية المستخدَمة في الدفع المسبق. في المقابل، إذا أغلقت حساب الفوترة السحابية لأي سبب آخر، سيتم فقدان أي رصيد متبقٍ من الدفع المسبق ولن يتم ردّه.
شراء أرصدة
يمكنك شراء رصيد يدويًا مسبقًا قبل استخدام Gemini API لتحميله إلى رصيد حساب الدفع المسبق.
لشراء وحدات، انتقِل إلى صفحة الفوترة في AI Studio وانقر على شراء وحدات. الحدّ الأدنى للشراء هو 5 دولار أمريكي. الحدّ الأقصى لمبلغ الرصيد الذي يمكنك دفعه مسبقًا هو 5,000 دولار أمريكي.
إعادة التحميل التلقائي
ميزة "تعبئة الرصيد تلقائيًا" هي ميزة اختيارية تعمل على إضافة رصيد إلى حسابك للدفع المسبق تلقائيًا عندما يكون رصيدك منخفضًا. ويفيد ذلك في تجنُّب انقطاع الخدمة.
يمكنك إعداد ميزة "تعبئة الرصيد تلقائيًا" والاطّلاع على حالتها في بطاقة الرصيد المتاح ضمن صفحة الفوترة في AI Studio. انقر على إعداد ميزة "تعبئة الرصيد تلقائيًا" أو إدارة ميزة "تعبئة الرصيد تلقائيًا" لضبط طريقة الدفع ومبلغ تعبئة الرصيد والحد الأدنى للرصيد الذي يؤدي إلى إجراء دفعة تلقائية.
الحد الأقصى الشهري للدفع التلقائي
يتوفّر حدّ التكلفة الشهرية التلقائية لمستخدمي "الدفع المسبق"، ويساعد في منع التكاليف غير المتوقّعة الناتجة عن عمليات إعادة تعبئة الرصيد التلقائية المتكرّرة. استخدِم هذه الميزة لضبط حدّ أقصى لعمليات إعادة تعبئة الرصيد التلقائية خلال دورة فوترة واحدة. وبعد أن يبلغ إجمالي مبلغ عمليات إعادة التعبئة التلقائية في دورة الفوترة هذا الحدّ، سيوقف النظام ميزة "تعبئة الرصيد تلقائيًا" إلى حين بداية الشهر التالي. لا تُحتسب الدفعات لمرة واحدة التي تبدأها يدويًا ضمن هذا الحدّ.
لضبط الحد الأقصى للرسوم التلقائية الشهرية عند تفعيل ميزة "تعبئة الرصيد تلقائيًا"، اتّبِع الخطوات التالية:
- انتقِل إلى صفحة فوترة AI Studio.
- انقر على إدارة ميزة "تعبئة الرصيد تلقائيًا".
- وسِّع قسم الحدّ الشهري وأدخِل الحدّ الأقصى الشهري لعمليات تعبئة الرصيد تلقائيًا.
- انقر على حفظ.
الدفع عند الاستخدام
في خطة الفوترة "الدفع عند الاستخدام"، تتراكم التكاليف في حسابك على Cloud Billing ويتم تحصيل الرسوم منك تلقائيًا في نهاية الشهر، أو عندما تصل تكاليفك إلى حدّ إنفاق يتم تحديده تلقائيًا استنادًا إلى فئة حسابك. يتم تحصيل الدفعة من طريقة الدفع المرتبطة بحسابك على Postpay، ويمكنك إدارة ذلك من صفحة الفوترة في AI Studio. في صفحة الفوترة، ستتمكّن من الاطّلاع على رصيدك وتواريخ الاستحقاق والدفعات السابقة، بالإضافة إلى إجراء الدفعات وإدارة طرق الدفع.
عند إعداد الفوترة لمشروع جديد، إذا كنت مؤهلاً للاستفادة من ميزة "الدفع عند الاستخدام"، سيظهر لك خياران، هما "الدفع المسبق" و"الدفع عند الاستخدام"، في مربّع الحوار إعدادات الفوترة.
بعد التبديل إلى خطة الفوترة بنظام الدفع الآجل في حساب فوترة Cloud، يتم التبديل إلى هذه الخطة في جميع المشاريع المرتبطة بحساب الفوترة هذا. يمكنك نقل حساب مؤهَّل إلى نظام الدفع المسبق باتّباع الخطوات الواردة في نقل البيانات إلى نظام الدفع المسبق. يمكنك أيضًا نقل مشروع إلى حساب فوترة يتضمّن خطة فوترة مختلفة لتغيير دورة الفوترة لهذا المشروع. يُرجى الاطّلاع على مستندات Cloud حول إدارة الفوترة للمشاريع.
يمكنك الاطّلاع على مزيد من المعلومات عن دورة الفوترة في نظام "الدفع عند الاستخدام" في دليل فوترة Cloud.
نقل البيانات إلى الدفع المسبق
نحن بصدد نقل حسابات المطوّرين على Google AI Studio من نظام "الدفع عند الاستخدام" إلى نظام "الدفع المسبق" مقابل استخدام Gemini API. لا ينطبق هذا التغيير إلا على Gemini API، وستبقى خدمات Google Cloud الأخرى المرتبطة بحساب الفوترة الخاص بك على نظام الدفع الآجل.
يمكنك التبديل إلى نظام الدفع المسبق وإضافة أرصدة قبل تاريخ التبديل المذكور في إشعار حسابك لتجنُّب انقطاع الخدمة. لا تحتاج الحسابات التي تستخدم ميزات "المستوى المجاني" فقط إلى اتّخاذ أي إجراء.
لتحويل حساب حالي يستخدم نظام الدفع عند الاستخدام إلى نظام الدفع المسبق، اتّبِع الخطوات التالية:
- انتقِل إلى صفحة فوترة AI Studio.
- انقر على التبديل إلى نظام الدفع المسبق لحساب الفوترة.
- شراء رصيد (الحدّ الأدنى هو 5 دولار أمريكي) لتحميل رصيدك الأولي
لتجنُّب انقطاع الخدمة بعد التبديل، اضبط تعبئة الرصيد تلقائيًا لإعادة تعبئة رصيدك عندما ينخفض.
حدود الإنفاق
تتيح Gemini API وضع حدود قصوى للإنفاق الشهري على مستوى كلّ من فئة حساب الفوترة والمشاريع. تم تصميم عناصر التحكّم هذه لحماية حسابك من التجاوزات غير المتوقّعة، ولحماية النظام المتكامل لضمان توفّر الخدمة.
يُرجى العِلم أنّ حدود الإنفاق غير متاحة للحسابات التي يتم إرسال الفواتير إليها (أو الحسابات غير الإلكترونية).
حدود الإنفاق القصوى للمشروع
يمكنك ضبط حدود الإنفاق على مستوى المشروع في AI Studio. ويكون ذلك مفيدًا إذا كان لديك مشاريع متعددة ضمن حساب الفوترة نفسه وأردت التأكّد من أنّ كل مشروع يمكنه الاستفادة من الحدّ الأقصى للإنفاق التراكمي.
يمكن للحسابات التي لديها أدوار محرّر المشروع أو المالك أو المشرف ضبط حدود الإنفاق القصوى لكل مشروع في AI Studio من خلال صفحة الإنفاق ضمن حد الإنفاق الأقصى الشهري > تعديل حد الإنفاق الأقصى.
للحصول على تفاصيل حول أذونات Cloud IAM المحدّدة في Google Cloud المطلوبة لعرض حدود الإنفاق ومعلومات الفوترة أو تعديلها في AI Studio، يُرجى الاطّلاع على دليل تحديد المشاكل وحلّها في AI Studio.
في حال نقل مشروع إلى حساب فوترة مختلف، سيظلّ أي حدّ أقصى للإنفاق سبق أن ضبطته لهذا المشروع ساريًا، ولكن ستتم إعادة ضبط أي إنفاق متراكم إلى 0 دولار أمريكي لدورة الفوترة الجديدة.
قد تتجاوز تكلفة المهام التي تستغرق وقتًا طويلاً، مثل عمليات إكمال الوضع المجمّع وجلسات الوكيل، الحدّ الأقصى للإنفاق في مشروعك.
قد تتأخر أوقات معالجة بيانات الفوترة في AI Studio لمدة تصل إلى 10 دقائق تقريبًا. قد تتجاوز الحد الأقصى للمشروع إذا لم تتم معالجة بيانات الفوترة قبل تراكم المزيد من الرسوم.
حدود الإنفاق القصوى لمستوى حساب الفوترة
يحتوي كل مستوى على حدّ أقصى للإنفاق الشهري:
| فئة الاستخدام | الحدّ الأقصى للإنفاق |
|---|---|
| Free | لا ينطبق |
| المستوى 1 | 250 دولار أمريكي |
| المستوى 2 | $2,000 |
| المستوى 3 | 20,000 - 100,000 دولار أمريكي |
يتم فرض حدود قصوى للاستخدام الشهري لواجهة Gemini API على مستوى حساب الفوترة. على الرغم من أنّ الحدود التلقائية تكون مضبوطة مسبقًا، يمكنك طلب زيادة لاستيعاب الاستخدام الأعلى. يتم تجميع إجمالي الإنفاق على مستوى جميع المشاريع المرتبطة التي تم تفعيل خدمة Gemini API فيها. بعد أن يصل إجمالي الحساب التراكمي إلى حد الفئة، يتم إيقاف الخدمة مؤقتًا لجميع المشاريع المرتبطة بحساب الفوترة هذا إلى حين بدء دورة الفوترة التالية (اليوم الأول من كل شهر).
تقييم الإنفاق في حساب الفوترة
لتقييم إنفاقك الشهري السابق وتحديد ما إذا كانت حدود الإنفاق الجديدة على مستوى فئة حساب الفوترة ستؤثر في مشاريعك الحالية، اتّبِع الخطوات التالية:
- في Google Cloud Console، اعرض صفحة تقارير حساب فوترة Cloud.
- إذا كان لديك أكثر من حساب فوترة واحد، اختَر حساب فوترة Cloud الذي تريد عرض تقارير التكاليف الخاصة به، عندما يُطلب منك ذلك.
- يتم ضبط التقرير تلقائيًا على "التجميع حسب الخدمة" في "الشهر الحالي". سيظهر Gemini API في عمود الخدمة وإجمالي الإنفاق في عمود تكلفة الاستخدام في الجدول.
- للاطّلاع على التكاليف التفصيلية التي تقتصر على استخدام Gemini API، اضبط فلتر التجميع حسب على التجميع حسب رمز التخزين التعريفي، وفلتر الخدمات على Gemini API.
- اضبط فلتر النطاق الزمني حسب تاريخ الاستخدام على النطاق الذي تريده لتقييم إنفاقك السابق خلال فترة زمنية.
مدد المعالجة
لا تتم دائمًا إشارات الفوترة والتعديلات في الوقت الفعلي.
- استخدام الرصيد: يتم عادةً خصم تكاليف الاستخدام من رصيدك في غضون دقائق.
- تأكيد الدفع: على الرغم من أنّ معظم عمليات الدفع باستخدام البطاقات تتم بشكل فوري، قد تستغرق بعض طرق الدفع (مثل الحوالات المصرفية) عدة أيام لتتم معالجتها. لا يمكن استئناف الخدمات أو ترقيتها إلا بعد تأكيد شراء الرصيد رسميًا.
- الترقيات إلى فئة أعلى: بعد إتمام عملية الدفع بنجاح أو استيفاء معايير الترقية، تظهر الترقيات إلى فئة أعلى عادةً في غضون 10 دقائق.
- الرسومات البيانية لتفاصيل التكلفة الإجمالية: قد يستغرق تعديل الرسومات البيانية التي تعرض تفاصيل التكلفة الإجمالية في كلّ من صفحة الفوترة وصفحة الإنفاق مدة تصل إلى 24 ساعة.
يمكنك الاطّلاع على أدلة الفوترة في السحابة الإلكترونية حول دورة الفوترة وفترات التأخير في المعاملات لمعرفة المزيد عن حالات التأخير المحتملة في الفوترة.
عمليات ردّ الأموال
لا يُسمح بردّ الأموال لحسابات الفوترة الدفع المسبق، إلا عند تبديل أنواع الحسابات.
عندما يتم التبديل من حساب يستخدم نظام الدفع المسبق إلى حساب يستخدم نظام الدفع عند الاستخدام (بعد استيفاء المعايير والترقية يدويًا لحسابك)، يتم إغلاق حساب الدفع المسبق ويتم تلقائيًا ردّ أي رصيد مسبق الدفع متبقٍ إلى طريقة الدفع المحفوظة.
في حال إغلاق حسابك الذي يستخدم طريقة الدفع المُسبَق لأي سبب آخر غير الترقية إلى طريقة الدفع عند الاستخدام، سيتم إلغاء أي أرصدة متبقية مدفوعة مسبقًا.
تنتهي صلاحية الأرصدة التي يتم شراؤها بعد عام واحد. بعد انتهاء صلاحية الرصيد، سيتم مصادرته ولن يكون بإمكانك استرداده.
تخضع حسابات الدفع عند الاستخدام لسياسة ردّ الأموال في Google Cloud.
حسابات الفوترة في السحابة الإلكترونية
تستخدم Gemini API حسابات الفوترة في Cloud لخدمات الفوترة، ويمكنك إعدادها مباشرةً في AI Studio. يمكنك استخدام AI Studio لتتبُّع الإنفاق وفهم التكاليف وتسديد الدفعات.
يتم تحديد الفئات وحدود المعدّل القصوى وحدود حساب الفوترة على مستوى حساب الفوترة.
المشاريع ومفاتيح واجهة برمجة التطبيقات
ترث جميع المشاريع المرتبطة بحساب فوترة في السحابة الإلكترونية فئة الاستخدام وحدود المعدّل القصوى وحدود الحساب المرتبطة بحساب الفوترة. في حال تغيير مشروع من حساب فوترة إلى آخر، سيتم تبديل فئته، وبالتالي حدود المعدّل القصوى وحدود الحساب، إلى فئة حساب الفوترة الجديد.
يتم احتساب الإنفاق التراكمي (على جميع منتجات Google Cloud) وعمر الحساب في جميع المشاريع المرتبطة بحساب فوترة ضمن مؤهلات الفئة الخاصة بحساب الفوترة هذا.
يمكنك إلغاء ربط مشروع بحساب الفوترة للرجوع إلى الطبقة المجانية.
مفاتيح واجهة برمجة التطبيقات هي بيانات اعتماد يتم إنشاؤها داخل مشروع. ولا تتضمّن أي إعدادات فوترة مستقلة، بل تستخدم حدود الفئة وحالة الفوترة الخاصة بالمشروع. يتم احتساب الاستخدام التراكمي من جميع المفاتيح ضِمن مشروع معيّن ضمن الحد الأقصى للإنفاق الخاص بهذا المشروع وإجمالي الإنفاق الخاص بحساب الفوترة.
الأسئلة الشائعة
تقدّم الأقسام التالية إجابات عن الأسئلة الشائعة.
ما هي الرسوم التي يتم تحصيلها مني؟
يستند تسعير Gemini API إلى ما يلي:
- عدد الرموز المميّزة المدخَلة
- عدد الرموز المميّزة الناتجة
- عدد الرموز المميّزة المخزَّنة مؤقتًا
- مدة تخزين الرمز المميّز المخزّن مؤقتًا
للحصول على معلومات عن الأسعار، يُرجى الاطّلاع على صفحة الأسعار.
أين يمكنني الاطّلاع على حصتي؟
يمكنك الاطّلاع على الحصة المخصّصة لك وحدود النظام في AI Studio.
كيف يمكنني الانتقال إلى فئة أعلى من الحدّ الأقصى لمعدّل الطلبات أو طلب المزيد من الحصة؟
سيتم تلقائيًا منحك المزيد من الحصة عندما يستوفي حسابك متطلبات المستوى التالي.
هل يمكنني استخدام Gemini API بدون أي تكلفة في المنطقة الاقتصادية الأوروبية (بما في ذلك الاتحاد الأوروبي) والمملكة المتحدة وسويسرا؟
نعم، تتوفّر الطبقة المجانية والطبقة المدفوعة في العديد من المناطق.
إذا أعددت الفوترة باستخدام Gemini API، هل سيتم تحصيل رسوم مني مقابل استخدام Google AI Studio؟
يبقى استخدام AI Studio بدون أي تكلفة ما لم يربط المستخدمون مفتاح API مدفوعًا للوصول إلى الميزات المدفوعة. بعد ربط مفتاح واجهة برمجة تطبيقات مدفوعة كجزء من مشروع مدفوع في AI Studio، سيتم تحصيل رسوم منك مقابل استخدام AI Studio لهذا المفتاح. يمكنك التبديل بين مشاريع "الفئة المدفوعة" ومشاريع "الفئة المجانية" حسب الحاجة باستخدام مفاتيح واجهة برمجة التطبيقات المرتبطة بكل نوع.
إذا كنت مشتركًا في "الخطة المجانية"، كيف يمكنني الترقية إلى خطط أعلى؟
للوصول إلى مستويات أعلى، عليك إعداد الفوترة في مشروعك. انقر على إعداد الفوترة في Google AI Studio. سيرشدك ذلك خلال عملية اختيار حساب فوترة على Cloud أو إنشائه. إذا كان عليك استخدام نموذج الفوترة المدفوعة مسبقًا، ستساعدك عملية إعداد الفوترة في إنشاء حساب الدفع المسبق المرتبط بحساب الفوترة في السحابة الإلكترونية.
هل يمكنني استخدام مليون رمز مميز في المستوى المجاني؟
يختلف المستوى المجاني من Gemini API حسب النموذج الذي تم اختياره. يمكنك حاليًا تجربة قدرة استيعاب مليون رمز مميّز بالطرق التالية:
- في Google AI Studio
- مع خطط مجانية لطُرز محدّدة
- مع خطط الدفع عند الاستخدام
هل يمكنني الرجوع إلى "الطبقة المجانية" بعد الترقية إلى طبقات أعلى (مدفوعة)؟
للرجوع إلى "الطبقة المجانية"، يمكنك إيقاف الفوترة في كل مشروع تريد الرجوع إليه.
كيف يمكنني احتساب عدد الرموز المميزة التي أستخدمها؟
استخدِم طريقة GenerativeModel.count_tokens
لاحتساب عدد الرموز المميزة. راجِع دليل الرموز المميّزة لمعرفة المزيد من المعلومات حول الرموز المميّزة.
إذا اشتركتُ في أول حساب فوترة على Cloud من خلال AI Studio، هل سأظلّ مؤهَّلاً للحصول على فترة تجريبية مجانية من Google Cloud؟
عند الاشتراك في أول حساب فوترة لك على Cloud، تبدأ الفترة التجريبية المجانية من Google Cloud ويتم منحك رصيدًا ترحيبيًا بقيمة 300 دولار أمريكي. ومع ذلك، لا يمكن استخدام هذه الأرصدة للدفع مقابل استخدام AI Studio. يمكنك استخدام رصيد الترحيب للدفع مقابل خدمات أخرى مؤهَّلة ضمن Google Cloud (يُرجى العِلم أنّه بعد استهلاك هذه الأرصدة أو انتهاء صلاحيتها (خلال 90 يومًا)، يتم تلقائيًا تحصيل رسوم أي استخدام إضافي من طريقة الدفع التي حدّدتها).
هل يمكنني استخدام رصيدي الترحيبي على Google Cloud مع Gemini API؟
لا، لا يمكن استخدام رصيد الترحيب أو الرصيد التجريبي المجاني في Google Cloud مع Gemini API أو AI Studio.
إذا تم منحك رصيدًا ترحيبيًا من Google Cloud قبل أن تصبح غير مؤهّل، سيظل بإمكانك إنفاق الرصيد المتبقي على Gemini API وAI Studio إلى أن تنتهي صلاحية الرصيد (بعد 90 يومًا).
هل تنطبق الفترة التجريبية المجانية من Google Cloud على استخدام Gemini API؟
لا، اعتبارًا من آذار (مارس) 2026، سيتم استبعاد تكاليف استخدام Gemini API تحديدًا من برنامج الفترة التجريبية المجانية من Google Cloud بقيمة 300 دولار أمريكي.
كيف تعمل أرصدة Google Cloud مع خيار الدفع المُسبَق؟
على مستخدمي الدفع المسبق أولاً شراء أرصدة الدفع المسبق قبل أن يتم تطبيق أي أرصدة مؤهّلة من Google Cloud على استخدام Gemini API. بعد أن يتوفّر لديك رصيد نشط في حساب الدفع المسبق، سيتم استهلاك أرصدة Google Cloud المؤهَّلة لاستخدام Gemini API قبل استهلاك رصيد الدفع المسبق. عندما يصل رصيد الدفع المسبق في حساب الفوترة إلى 0 دولار أمريكي، لن يتم استهلاك رصيد Google Cloud بعد ذلك.
لا يمكن استخدام بعض أرصدة Google Cloud، مثل رصيد الترحيب من Google Cloud، مع Gemini API وAI Studio.
كيف تتم إدارة الفوترة؟
تتم معالجة الفوترة لواجهة Gemini API من خلال نظام الفوترة على Google Cloud. يمكنك الاطّلاع على مزيد من المعلومات عن عملية إعداد الفوترة في Cloud داخل المنتج في مستندات Cloud Billing.
هل يتم تحصيل رسوم مني مقابل الطلبات التي تعذّر تنفيذها؟
إذا تعذّر تنفيذ طلبك وظهرت رسالة الخطأ 400 أو 500، لن يتم تحصيل رسوم منك مقابل الرموز المميزة المستخدَمة. ومع ذلك، سيتم احتساب الطلب ضمن حصتك.
هل يتم تحصيل رسوم مقابل GetTokens؟
لا يتم تحصيل رسوم مقابل الطلبات إلى واجهة برمجة التطبيقات GetTokens، ولا يتم احتسابها ضمن حصة الاستدلال.
كيف تتم معالجة بياناتي في Google AI Studio إذا كان لديّ حساب API مدفوع؟
راجِع بنود الخدمة للحصول على تفاصيل حول طريقة معالجة البيانات عند تفعيل الفوترة في Cloud (اطّلِع على "طريقة استخدام Google لبياناتك" ضمن "الخدمات المدفوعة"). يُرجى العِلم أنّ طلباتك في Google AI Studio تخضع لبنود "الخدمات المدفوعة" نفسها ما دام تم تفعيل الفوترة في مشروع واحد على الأقل من مشاريع واجهة برمجة التطبيقات، ويمكنك التأكّد من ذلك من خلال صفحة مفتاح Gemini API إذا رأيت أي مشاريع مصنّفة على أنّها "مدفوعة" ضمن "الخطة".
ما هي الفوترة المدفوعة مسبقًا ومن يُطلب منه استخدام نموذج الفوترة المدفوعة مسبقًا؟
تتيح الفوترة المدفوعة مُسبقًا لمستخدمي Gemini API في AI Studio الشراء بشكل مسبق للأرصدة. اعتبارًا من 23 مارس 2026، قد يُطلب من المستخدمين الجدد في AI Studio الاشتراك في خطة الفوترة المدفوعة مسبقًا. أثناء عملية إعداد الفوترة في AI Studio، سترشدك واجهة المستخدم خلال خطوات إعداد الفوترة، وستوضّح لك ما إذا كان عليك الدفع مسبقًا.
كيف يمكنني شراء أرصدة Prepay، وهل هناك حدّ أدنى أو أقصى؟
يمكنك شراء وحدات من صفحة الفوترة في AI Studio. أثناء عملية الشراء، ستوفّر واجهة المستخدم الحدّ الأدنى لمبلغ الشراء المسبق المطلوب في منطقتك ومستوى اشتراكك، بالإضافة إلى الحدّ الأقصى للمبلغ الذي يمكن أن يكون في حسابك في وقت واحد.
هل يمكنني ضبط حساب الدفع المُسبَق لشراء المزيد من الرصيد تلقائيًا حسب الحاجة؟
نعم، ننصحك بضبط إعدادات إعادة التحميل التلقائي في إعدادات الفوترة في AI Studio. عليك تحديد رصيد "مشغِّل" (مثل "عندما ينخفض رصيدي عن 30 دولارًا أمريكيًا") و "قيمة إعادة التعبئة" (مثل "إضافة 100 دولار أمريكي").
هل يمكنني وضع حدّ لمبلغ رسوم إعادة التعبئة التلقائية؟
نعم، يمكن لمستخدمي الدفع المُسبَق ضبط حدّ شهري للخصم التلقائي ضمن أداة تعبئة الرصيد تلقائيًا. عندما يصل المبلغ الإجمالي لعمليات إعادة التعبئة التلقائية في دورة الفوترة إلى هذا الحد، سيوقف النظام ميزة "تعبئة الرصيد تلقائيًا" حتى الشهر التالي. لا يتم احتساب عمليات شراء الرصيد اليدوية ضمن هذا الحدّ.
هل يمكنني استرداد الأموال المدفوعة مقابل الرصيد غير المستخدَم؟
تنتهي صلاحية جميع أرصدة واجهة برمجة التطبيقات المدفوعة مسبقًا بعد عام واحد ولا يمكن استردادها. اطّلِع على سياسة ردّ الأموال لحسابات الدفع المسبق.
هل تنتهي صلاحية الأرصدة المدفوعة مسبقًا؟
نعم، تنتهي صلاحية الأرصدة بعد 12 شهرًا من تاريخ شرائها.
ماذا يحدث عندما يصل رصيد الدفع المُسبق إلى 0 دولار أمريكي؟
سيتم إيقاف جميع خدمات Gemini API في جميع المشاريع المدفوعة من خلال حساب Cloud Billing Prepay على الفور لمنع تكبّد المزيد من الرسوم. لن يتم تلقائيًا خفض مستوى مشاريعك إلى "الفئة المجانية".
لاستعادة الخدمة على مستوى "الفئة المدفوعة" الحالي، عليك شراء رصيد إضافي. بعد شراء الوحدات، من المفترض أن تتمكّن من استخدام Gemini API. يُرجى العِلم أنّه قد يحدث تأخير أثناء تعديل أنظمتنا لتعكس رصيد الائتمان.
يمكنك اختياريًا إيقاف الفوترة في المشاريع التي تريد الرجوع إلى إصدار سابق منها، وذلك للرجوع إلى "الطبقة المجانية".
لماذا توقّف استخدامي على الرغم من أنّ رصيد الدفع المسبق أكبر من 0 دولار أمريكي؟
ربما بلغت سقف الاستخدام في فئتك الحالية. ستزداد حدود الاستخدام تلقائيًا عند الانتقال إلى مستويات أعلى. قد يتأثر استخدامك لواجهة Gemini API في AI Studio أيضًا بحالة حساب الفوترة على Cloud.
لماذا رصيد حساب الدفع المسبق سالب؟
نظرًا لتعقيد أنظمة الفوترة والمعالجة لدينا، قد يحدث تأخير في قدرتنا على إيقاف الاستخدام بعد استهلاك جميع أرصدتك. قد يظهر هذا الاستخدام الزائد كرصيد سلبي في لوحة بيانات الفوترة في AI Studio. في هذه الحالة، سيتم إيقاف خدمتك مؤقتًا، وسيتم خصم رصيدك السالب من عملية شراء الرصيد التالية.
لتجنُّب توقّف خدمة Gemini API مؤقتًا، ننصحك بإعداد ميزة إعادة التحميل التلقائي لشراء المزيد من الرصيد تلقائيًا عندما ينخفض رصيدك إلى أقل من قيمة تحدّدها.
هل يمكنني استخدام أرصدة Prepay لخدمات Google Cloud الأخرى، مثل Gemini Enterprise Agent Platform؟
لا، فالأرصدة المدفوعة مسبقًا مخصّصة حصريًا لاستخدام Gemini API. يتم تحصيل رسوم أي خدمات أخرى من Google Cloud تستخدمها (مثل Compute وStorage وGemini Enterprise Agent Platform) باستخدام دورة الفوترة العادية في Cloud.
هل يمكنني التبديل من الفوترة بنظام الدفع المسبق إلى نظام الدفع عند الاستخدام؟
لا، لا يمكن التبديل من خطة فوترة للدفع المُسبَق إلى خطة فوترة للدفع عند الاستخدام.
هل يمكنني التبديل من "الدفع عند الاستخدام" إلى "الدفع المسبق"؟
نعم، يمكنك نقل حساب Postpay حالي من صفحة فوترة AI Studio. راجِع مقالة الانتقال إلى الدفع المسبق للحصول على التعليمات.
ماذا يحدث لرصيد الدفع المُسبق إذا بدّلت إلى طريقة الدفع عند الاستخدام؟
عند الترقية إلى الدفع عند الاستخدام، سيغلق حساب الفوترة على Cloud حساب الدفع المُسبَق، ويوقف ميزة تعبئة الرصيد تلقائيًا، ويردّ إليك تلقائيًا أي رصيد غير مستخدَم من رصيد الدفع المُسبَق (مع مراعاة وقت معالجة عمليات ردّ الأموال المعتاد).
أين يمكنني الاطّلاع على رصيد بطاقة الدفع المسبق الحالي وسجلّ المعاملات؟
يجب إجراء جميع عمليات إدارة الرصيد وسجلّ المعاملات في Gemini API مباشرةً ضمن علامة التبويب "الفوترة" في Google AI Studio.
لماذا تظهر لي الرسالة "نوع حساب الفوترة غير نشط أو غير متوافق"؟
قد يتم حظر التفاعلات المتعلقة بالدفع في صفحة الفوترة في AI Studio واستبدالها بالرسالة "نوع حساب الفوترة غير نشط أو غير متوافق" إذا كان نوع حساب الفوترة المحدّد أو حالة حساب الفوترة غير مؤهّلة للاستفادة من "الخطة المدفوعة" في AI Studio.
تحقَّق من Cloud Console للاطّلاع على حالة حساب الفوترة. أحد الأنواع غير المؤهَّلة هو حساب الفترة التجريبية المجانية، وفي هذه الحالة، يمكنك تفعيل الفوترة في AI Studio لتصبح مؤهَّلاً. إحدى حالات عدم النشاط هي مغلق، وفي هذه الحالة يمكنك إعادة فتح الحساب.
هل ستظهر تكاليف استخدام Gemini API في "وحدة تحكّم Google Cloud"؟
نعم، يمكن الاطّلاع على تكاليف Gemini API، بالإضافة إلى التكاليف المرتبطة بأي خدمات أخرى من Google Cloud يتم دفعها من خلال حساب الفوترة في Cloud، وذلك في صفحات إدارة التكاليف في وحدة تحكّم الفوترة في Cloud. يُرجى العِلم أنّه يمكنك إدارة رصيد الدفع المسبق في AI Studio فقط.
لماذا لا يظهر استخدام Gemini API في Cloud Billing Console، مع أنّه يظهر في "فوترة AI Studio"، بالإضافة إلى استهلاك الرصيد؟
تُرسِل Google Cloud وAI Studio بيانات الاستخدام إلى خدمة Cloud Billing على فترات زمنية مختلفة. بسبب تعقيد أنظمة الفوترة والمعالجة لدينا، قد يحدث تأخير بين استخدامك للخدمات وتوفُّر بيانات الاستخدام والتكاليف في "الفوترة في Cloud". تتوفّر تفاصيل التكلفة عادةً في غضون يوم واحد، ولكن قد تستغرق أكثر من 24 ساعة في بعض الأحيان. يمكنك الاطّلاع على مزيد من المعلومات عن الفوترة المؤجّلة في مستندات "فوترة Cloud".
إذا كنت أستخدم خدمات أخرى من Google Cloud تتضمّن تكاليف تخضع لدورة تحصيل الرسوم عند الاستخدام، ماذا يحدث إذا لم أسدّد دفعة؟
قد يؤدي عدم دفع رسوم خدمات Google Cloud الأخرى إلى تعليق إمكانية الوصول إلى Gemini API في AI Studio، بغض النظر عن عدد أرصدة الدفع المُسبَق المتوفّرة لديك. يتم تفعيل استخدام AI Studio من خلال حساب فوترة على Google Cloud، ويمكن أن يشارك هذا الحساب في كلّ من الفوترة المسبقة الدفع في AI Studio والفوترة اللاحقة الدفع في خدمات Cloud الأخرى. تؤدي المشكلة في رصيد Postpay إلى إيقاف جميع الخدمات المرتبطة بهذا الحساب. سيتم تعليق استخدامك لواجهة Gemini API إذا تم الإبلاغ عن حساب الفوترة الخاص بك في Cloud بسبب مشاكل مثل:
- رصيد متأخّر أو مستحق
- دفعة مرفوضة
- طريقة دفع غير صالحة أو منتهية الصلاحية
لاستعادة الخدمة، عليك حلّ مشكلة حساب الدفع الآجل في وحدة تحكّم الفوترة في Google Cloud. بعد حلّ المشكلة، ستستعيد إمكانية الوصول إلى أرصدة وخدمات Gemini API المدفوعة مسبقًا.
لماذا يتم إيقاف مشاريعي بعد إلغاء عملية إعداد "الدفع المُسبق"؟
المشكلة: بدأت عملية إضافة إمكانات الدفع المسبق إلى حساب فوترة حالي يستخدم إعداد "الدفع عند الاستخدام"، ولكنك أغلقت النافذة أو ألغيت العملية قبل إكمال إعداد الدفع المسبق. فقدت المشاريع الأخرى المرتبطة بحساب الفوترة هذا إمكانية الوصول إلى Gemini API.
السبب: أثناء عملية الانتقال، يتم إنشاء البنية الأساسية التي تتيح استخدام ميزة "الدفع المسبق" في حساب الفوترة الخاص بك فور قبولك مربع حوار التأكيد. إذا لم تُكمل خطوات الدفع المُسبق، سيظل الإعداد في حالة غير قابلة للتحصيل. بما أنّ هذه الحالة تنطبق على مستوى حساب الفوترة، فإنّها تقيّد إمكانية الوصول إلى جميع المشاريع المرتبطة بحساب الفوترة هذا والتي تعتمد على خدمات الدفع المسبق.
الحل: بما أنّ حالة الحساب قد تغيّرت بالفعل، لا تتوفّر طريقة تلقائية للرجوع إلى الحالة السابقة إذا أوقفت عملية الدفع. لاستعادة الخدمة إلى مشاريعك المرتبطة، اتّبِع أحد الإجراءات التالية:
- أكمِل عملية الإعداد: ارجع إلى Google AI Studio، وأعِد بدء خطوات إعداد الفوترة، وأكمِل عملية الدفع المسبق. بعد معالجة الدفعة، تصبح خطة الفوترة المدفوعة مسبقًا نشطة ويتم استعادة الخدمة.
- التواصل مع فريق الدعم: إذا كنت لا تريد استخدام خطة الفوترة بالدفع المسبق وتريد إعادة حساب الفوترة إلى خطة الدفع عند الاستخدام، يُرجى التواصل مع فريق دعم الفوترة في Cloud لإعادة ضبط حالة حسابك يدويًا.
أين يمكنني الحصول على المساعدة بشأن الفوترة؟
للحصول على مساعدة بشأن الفوترة، يُرجى الاطّلاع على الحصول على دعم بشأن الفوترة في Cloud.