أسعار Google Gemini: ما تكلفه واجهة API فعلياً

إجابة سريعة: ثلاثة أسعار مختلفة لـ Gemini

الباحثون عن أسعار Google Gemini يقصدون عادة واحداً من ثلاثة أشياء مختلفة، ولا تجعل Google التمييز واضحاً. أولاً، الاشتراك الاستهلاكي. خطة تطبيق Gemini المدفوعة (Google AI Pro) رسم ثابت بحوالي $20 شهرياً. تغطي الـ chatbot وميزات التطبيق، وليس API. لا شيء تدفعه هناك يرفع حصتك من API ولو بطلب واحد. ثانياً، Gemini API عبر Google AI Studio. هذا ما يدمجه المطورون فعلياً. لديه فئة مجانية حقيقية بحدود معدل صارمة، وفئة مدفوعة تُحاسِب لكل مليون token بلا رسم شهري. مشروع هواية يكلف عادة أرقاماً أحادية بالدولار شهرياً؛ وتطبيق إنتاج صغير يقع في المئات. ثالثاً، Vertex AI. نفس النماذج، غلاف مؤسسي، فوترة Google Cloud، وأسعار لكل token في نفس النطاق. إذا كان السعر هو سؤالك، فأنت شبه مؤكد تريد AI Studio لا Vertex. تغطي بقية هذا الدليل واجهة API: ما تسمح به الفئة المجانية، وما يكلفه الاستخدام المدفوع عند أحجام واقعية، وما تفعله عندما يبدأ محدد المعدل بإرجاع أخطاء 429.

فئات أسعار Gemini API وحدود معدل الفئة المجانية

تقيس Gemini API ثلاثة أشياء في آنٍ واحد: الطلبات في الدقيقة (RPM)، وtokens في الدقيقة (TPM)، والطلبات في اليوم (RPD). أياً كان السقف الذي تصل إليه أولاً، تُجيب واجهة API بـ429 حتى تُعاد تلك النافذة. تُطبَّق الحدود لكل مشروع Google Cloud ولكل نموذج، لذا إنشاء مفتاح ثانٍ داخل نفس المشروع لا يُغيّر شيئاً. تُراجع Google هذه الأرقام بشكل متكرر، لذا تعامل مع الجدول كشكل عام للنظام لا كعقد. الأرقام تقريبية لحدود فئة Flash اعتباراً من منتصف 2026؛ تحصل نماذج فئة Pro على أسقف أقل بكثير عند كل مستوى. تحقق من وثائق حدود المعدل لدى Google للأرقام الدقيقة المُطبَّقة على مشروعك اليوم.

المجانية مقابل المدفوعة: ما الذي يتغير فعلياً

إضافة حساب فوترة تفعل أكثر من رفع الأسقف. أكثر الفروق إغفالاً يكمن في الشروط: قد تستخدم Google prompts وردود الفئة المجانية لتحسين منتجاتها، وقد يشمل ذلك مراجعة بشرية. حركة API المدفوعة مُستبعَدة من تحسين المنتج. إذا كنت تختبر أي شيء حساس، هذا السطر أهم من أي حد معدل. سقف الطلبات اليومي هو الفرق العملي الآخر. في الفئة المجانية هو سقف صارم يُعاد ضبطه عند منتصف الليل بتوقيت المحيط الهادئ. لا استراتيجية إعادة محاولة تتجاوزه؛ تنتظر أو تُرقّي أو توجّه الحركة إلى مكان آخر.

اختبر فئتك من سطر الأوامر

استدعاء curl واحد يُخبرك إن كان مفتاحك يعمل وأي فئة أنت عليها فعلياً. تتضمن الاستجابة كتلة usageMetadata بأعداد tokens المدخل والمخرج الدقيقة، وهو الرقم الذي تضربه بالأسعار المُدرجة عند توقع الإنفاق. إذا حصلت على HTTP 429 بحالة RESOURCE_EXHAUSTED بدلاً من إكمال، فإما أنك استنفدت حصة اليوم من الفئة المجانية أو ترسل أسرع مما تسمح به نافذة الدقيقة.

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Explain token billing in one paragraph."}]}]}'

كم يكلف Gemini شهرياً: ثلاثة سيناريوهات

تستخدم هذه السيناريوهات Gemini 3.5 Flash بسعره المُدرج البالغ $1.50 لكل مليون token مدخل و$9.00 لكل مليون token مخرج. أمران يهيمنان على الحساب. تكلف tokens المخرج ستة أضعاف المدخل، لذا الردود المطوّلة هي الجزء المكلف. وتطبيقات المحادثة تعيد إرسال تاريخ المحادثة في كل دورة، لذا ينمو حجم المدخل بسرعة مع طول المحادثة ما لم تُقلّص السياق. إذا كان صف واجهة المحادثة يصف حمل عملك، لاحظ أن نفس الحساب ينطبق على أي نموذج، وأن نماذج الفئة الاقتصادية مثل DeepSeek V4 Flash تُغيّر الإجماليات بشكل كبير للاستخدام الحواري. ضع أيضاً ميزانية منفصلة لمهام المستندات الطويلة: تُحاسِب نماذج Gemini من فئة Pro بمعدل أعلى بمجرد أن يتجاوز الـ prompt عتبة السياق الكبير.

استكشاف أخطاء حدود معدل Gemini API وإصلاحها

خطأ 429 بـRESOURCE_EXHAUSTED عام، لذا ابدأ بمعرفة أي من العدادات الثلاثة أطلقته فعلياً. العميل أدناه يعيد المحاولة على اندفاعات الدقيقة العابرة بتراجع تدريجي ويستسلم بسرعة على أي شيء لا تُصلحه إعادة المحاولة.

• استنفاد السقف اليومي (الفئة المجانية): يُعاد ضبط عداد RPD عند منتصف الليل بتوقيت المحيط الهادئ. لا يساعد أي نمط إعادة محاولة؛ رقِّ الفئة أو انقل الحركة.
• اندفاعات RPM: العمّال المتوازيون وحلقات إعادة المحاولة الساذجة تُطلق حد الدقيقة حتى مع حجم يومي منخفض. أضف تراجعاً أسياً (exponential backoff) مع jitter.
• TPM يُطلَق مع سياق طويل: بضعة prompts من 100 ألف token يمكن أن تستنفد tokens في الدقيقة بينما يبدو معدل طلباتك ضئيلاً. قلّص التاريخ أو خزّن مؤقتاً البادئات الثابتة.
• الزر الخطأ: تُلحق الحدود بمشروع Google Cloud، لا بمفتاح API. إنشاء مفاتيح جديدة داخل نفس المشروع لا يفعل شيئاً.
• فئة النموذج: أسقف فئة Pro أقل بكثير من فئة Flash عند نفس المستوى. وجّه المهام الخلفية إلى Flash واحتفظ بـ Pro للاستدعاءات التي تحتاجه.

import random
import time

from google import genai
from google.genai import errors

client = genai.Client()  # يقرأ GEMINI_API_KEY من البيئة

def generate(prompt: str, retries: int = 5) -> str:
    for attempt in range(retries):
        try:
            resp = client.models.generate_content(
                model="gemini-3.5-flash", contents=prompt
            )
            return resp.text
        except errors.APIError as e:
            if e.code != 429 or attempt == retries - 1:
                raise
            time.sleep(min(2 ** attempt + random.random(), 30))
    raise RuntimeError("unreachable")

خيار البوابة: أسعار ثابتة، بلا سلّم فئات

إذا كانت العقبة لديك هي سلّم الفئات لا سعر token نفسه، فبوابة AI هي البديل العملي. تُقدِّم apisrouter.com نموذج gemini-3.5-flash بسعر $1.20 لكل مليون token مدخل و$7.20 لكل مليون مخرج، مع نماذج عالمية أقل بنسبة 20% من السعر الرسمي وفوترة بالدفع حسب الاستخدام بدلاً من اشتراك. لا يوجد نموذج تسجيل: ادفع عند /topup، ويصلك مفتاح API بالبريد الإلكتروني، وتضيف أول عملية تعبئة رصيد لك +100% للرصيد. تُصبح الحصة رصيداً تُنفقه بدلاً من تفاوض بالدقيقة مع نظام فئات. نقطة النهاية متوافقة مع OpenAI، لذا يعمل أي شيء يقبل base URL مخصصاً: وجّهه نحو https://api.apisrouter.com/v1 وستُملأ قائمة النماذج من /v1/models. يحمل نفس الكتالوج claude-sonnet-4-6 وgpt-5.5 وdeepseek-v4-flash وglm-5، مما يجعل اختبار A/B لـ Gemini مقابل البدائل تغييراً بسطر واحد.

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $KEAIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

الأسئلة الشائعة