أسعار Gemini Image API: حدود المعدل والدقة وكود Python

تكلف صورة Gemini الواحدة ما بين نحو ثلاثة سنتات وأربعة وعشرين سنتًا، والفارق بين الرقمين هو المكان الذي تذهب فيه معظم الميزانيات عن مسارها. اختر النموذج الخطأ، أو اطلب 4K حين يكفي 1K، أو تجاهل وضع الدفعات في مهمة ليلية، فقد تكلفك 10,000 صورة نفسها $336 أو $2,400. يأخذ هذا المقال الأرقام الفعلية من صفحتي الأسعار وحدود المعدل في Google، ويحوّلها إلى فواتير شهرية، وينتهي بكود Python يمكنك لصقه في سكربت اليوم.

💡 المصدر والتاريخ: قُرئت كل الأسعار أدناه من صفحة أسعار Gemini API المنشورة من Google في أكتوبر 2026. تعدّل Google هذه الأسعار، لذا تحقق من الصفحة المباشرة قبل أن تثبّت ميزانيتك.

أربعة نماذج، أربع نقاط سعرية

تبيع Google توليد الصور الأصلي لديها تحت اسم Nano Banana، وتعرض واجهة API أربعة نماذج. ثلاثة منها حالية وواحد قديم. لا يوجد أي من النماذج الحالية مستوى مجاني، لذا تُحتسب حتى أول مكالمة اختبار. كما تحمل كل صورة ناتجة علامة مائية SynthID.

أي نموذج يناسب أي مهمة

Nano Banana 2 Lite هو الخيار المناسب للأحجام الكبيرة. مصغرات الصور، وتنويعات المنتجات، ومسودات التجربة بنحو 3.4 سنت لكل صورة، مع تحفظ واحد: يُخرج 1K فقط.

Nano Banana 2 هو الخيار الافتراضي للعمل الإنتاجي. يمتد من 0.5K إلى 4K، ويدعم التأسيس على بحث Google (بما في ذلك التأسيس على بحث الصور في هذا النموذج)، ويكلف 6.7 سنت للصورة بدقة 1K.

Nano Banana Pro هو الخيار المتميز، الذي تضعه Google للمهام البصرية المعقدة. يبلغ سعره 13.4 سنت بدقة 1K أو 2K، لذا استخدمه حيث تكلفك إعادة توليد واحدة على نموذج أرخص وقتًا أكثر مما يكلفك فرق السعر نقودًا.

تقبل جميعها صورًا مرجعية، حتى 14 صورة حسب النموذج، فيمكنك تمرير صورة منتج أو عينة أسلوب مع الأمر النصي.

الانتقال من النموذج القديم

تصف وثائق Google gemini-2.5-flash-image بأنه الرائد القديم للسلسلة، وتوصي بالتحول إلى Nano Banana 2 Lite لجودة أفضل وتوليد أسرع وسعر API أقل. إذا كنت ما زلت تستدعيه في الإنتاج، فابدأ باستبدال معرّف النموذج، وأعد فحص عدد قليل من أوامرك النصية. يمكنك أيضًا مقارنة المخرجات جنبًا إلى جنب على PicassoIA، حيث ما زال Gemini 2.5 Flash Image مدرجًا، قبل أن تغيّر سطرًا واحدًا من الكود.

أسعار الصورة الواحدة حسب الدقة

تحتسب Google مخرجات الصور بالتوكنات، لكنها تنشر أيضًا سعرًا ثابتًا للصورة الواحدة لكل دقة، وهو الرقم الذي تضعه في الميزانية فعليًا.

أسعار القياس جنبًا إلى جنب

يلفت نمطان الانتباه. يكلف Nano Banana 2 عند 2K 1.5 ضعف سعره عند 1K، وعند 4K 2.25 ضعف. يُبقي Nano Banana Pro سعر 1K و2K متساويًا، لذا يكون 2K الخيار الافتراضي المنطقي هناك، ثم يقفز نحو 79 في المائة عند 4K.

تُحتسب المدخلات أيضًا: $0.50 لكل مليون توكن على Nano Banana 2، و$0.25 على Lite، و$2.00 على Pro. أمر نصي من بضع مئات من التوكنات يضيف جزءًا من السنت، لذا تهيمن مخرجات الصور على الفاتورة ما لم ترفق عددًا كبيرًا من الصور المرجعية.

وضع الدفعات يخفض الفاتورة إلى النصف

يبلغ سعر الدفعات نصف السعر القياسي على كل النماذج. ينخفض Nano Banana 2 إلى $0.034 عند 1K، و$0.050 عند 2K، و$0.076 عند 4K. يحصل Nano Banana Pro على الخفض نفسه بنسبة 50 في المائة. ينخفض سعر المخرجات على Nano Banana 2 Lite من 30 دولارًا إلى 15 دولارًا لكل مليون توكن، أي نحو 1.7 سنت للصورة.

مهام الدفعات غير متزامنة، لذا تناسب عمليات التصيير الليلية للكتالوجات، وتحديثات المصغرات بالجملة، وأي شيء لا ينتظر فيه أحد. لكنها لا تناسب زرًا ضغط عليه المستخدم للتو.

حساب التوكنات خلف السعر

اقسم سعر كل صورة على معدل المخرجات تحصل على عدد التوكنات لكل صورة. يعطي Nano Banana 2 بسعر $0.067 و$60 لكل مليون، نحو 1,120 توكنًا لصورة 1K، ونحو 1,680 عند 2K، ونحو 2,520 عند 4K. هذه الأعداد مشتقة من جدول أسعار Google، وليست منقولة عنه، لكنها توضح شكل التسعير.

يقترب Nano Banana Pro بسعر $0.134 و$120 لكل مليون أيضًا من 1,120 توكنًا عند 1K، بينما يعني سعره عند 4K البالغ $0.24 نحو 2,000 توكن. وهذا يجعل الفارق في السعر يتقلص عند 4K: فالسعر $0.24 مقابل $0.151 يساوي 1.6 مرة، مقارنة بالضعف تمامًا (2 مرة) عند 1K.

تنتج عن هذا قاعدة عملية واحدة. إعادة التوليد إنفاق حقيقي، والأمر النصي الذي يحتاج ثلاث محاولات يكلفك ثلاث صور.

حدود المعدل دون تخمين

تحدد حدود المعدل ما إذا كان خط المعالجة يعمل بسلاسة أم يتوقف عند الساعة 2 فجرًا خلف جدار من الأخطاء. تفرض Gemini API هذه الحدود لكل مشروع، وهناك تفاصيل قليلة يسهل إغفالها.

شرح RPM وIPM وRPD

تقيس Google الاستخدام وفق ثلاثة محاور: الطلبات في الدقيقة (RPM)، والتوكنات في الدقيقة (TPM)، والطلبات في اليوم (RPD). بالنسبة إلى نماذج الصور تستبدل الوثائق TPM بالصور في الدقيقة (IPM). إذا تجاوزت أي محور واحد فسيفشل الطلب، حتى لو كان المحوران الآخران بعيدين جدًا عن حدهما الأعلى.

ثلاث تفاصيل توقع الناس في الخطأ:

• الحدود لكل مشروع، لا لكل بيانات اعتماد. لن يمنحك رمز وصول ثانٍ داخل المشروع نفسه أي مساحة إضافية.
• يُعاد ضبط العداد اليومي عند منتصف الليل بتوقيت المحيط الهادئ. ليس بالتوقيت العالمي، وليس بمنتصف الليل المحلي لديك.
• الأرقام الدقيقة تخص كل نموذج. لا تنشرها Google في جدول الوثائق. تجدها في صفحة حد المعدل في AI Studio الخاصة بك (aistudio.google.com/rate-limit) وتتغير بحسب مستواك، لذلك لا يذكر هذا المقال أرقامًا قد تصبح قديمة.

مستويات الاستخدام وسقوف الإنفاق

يتبع مستواك حجم ما أنفقته:

إلى جانب RPM وIPM، تطبّق Google أسقف إنفاق على نافذة متحركة مدتها 10 دقائق. إذا تجاوزتها تحصل على خطأ 429 RESOURCE_EXHAUSTED. في عمل الصور يكون هذا السقف هو العائق غالبًا قبل RPM، لأن كل استدعاء مكلف. مطبَّقًا على أسعار الصور، يعمل تقريبًا على النحو التالي:

• Nano Banana 2 بدقة 1K ($0.067): نحو 149 صورة لكل نافذة في Tier 1، و746 في Tier 2، و2,985 في Tier 3.
• Nano Banana Pro بدقة 4K ($0.24): نحو 41 صورة فقط لكل نافذة في Tier 1.

هذا حسابي الخاص من الأسقف المنشورة، لذا اعتبره تقديرًا للتخطيط، وتحقق من حدودك الفعلية في AI Studio.

التعامل مع أخطاء 429

تعامل مع الخطأ 429 كحدث طبيعي لا كاستثناء. ثلاث عادات تُبقي خط المعالجة سليمًا:

1. أعد المحاولة مع تراجع أسّي وجيتر، بدءًا من نحو ثانية واحدة ومضاعفة المدة حتى سقف محدد.
2. نظّم الإيقاع من جهتك. اضبط دلو توكنات (token bucket) أدنى من سقف الإنفاق لعشر دقائق في مستواك، حتى لا تفعّله أبدًا.
3. انقل العمل غير العاجل إلى وضع الدفعات، الذي يخفض السعر إلى النصف ويُبقي المهام الطويلة خارج المسار التفاعلي.

تنفذ المساعدة في قسم Python أدناه العادة الأولى.

اختيارات الدقة ونسبة العرض إلى الارتفاع

تولّد نماذج صور Gemini 3 بدقة 1K افتراضيًا. الأحجام المدعومة هي 512 بكسل (0.5K) و1K و2K و4K، ويتوقف Nano Banana 2 Lite عند 1K. لم يُظهر جدول Google الذي قرأته سعرًا لمستوى 0.5K على Nano Banana 2، وتذكر المتتبعات الخارجية نحو $0.045، لذا تحقق من ذلك في الصفحة المباشرة قبل أن تعتمد عليه.

اختر الحجم بحسب الوجهة:

• مصغرات المدونة، ومنشورات التواصل، وقوائم المنتجات: 1K.
• البانرات الرئيسية والشاشات عالية الكثافة: 2K.
• الطباعة والقصّات الكبيرة: 4K، وللاختيارات النهائية فقط.

طريقة أرخص للحصول على ملفات كبيرة هي التوليد بدقة 1K ثم تمرير الفائز عبر نموذج لرفع الدقة الفائقة. على PicassoIA، يكبّر كل من Real ESRGAN وGoogle's Upscaler الصور بمقدار 4 أضعاف، ويستهدف Clarity Pro Upscaler النتائج الواقعية كالصور الفوتوغرافية. تضيف أدوات رفع الدقة حدة لا محتوى جديدًا، لذا جرّب واحدة مقابل تصيير 4K أصلي لصورك قبل أن تلتزم بها.

تستحق نسبة العرض إلى الارتفاع العناية نفسها. تتوفر عشر نسب: 1:1، و3:2، و2:3، و3:4، و4:3، و4:5، و5:4، و9:16، و16:9، و21:9. اختر قبل أن تولّد. إذا قُصّ تصيير بنسبة 16:9 ليصبح منشورًا بنسبة 4:5 فستخسر أكثر من نصف الإطار، وكل إعادة توليد تعني صورة أخرى تُحتسب.

كود Python الذي يعمل

ثبّت SDK بالأمر pip install google-genai واضبط بيانات اعتماد Gemini كمتغير بيئة. يقرأه العميل تلقائيًا، فلا تظهر أي أسرار في كودك المصدري.

مكالمة Interactions الأساسية

تولّد وثائق Google الحالية الصور عبر واجهة Interactions API. هذه أبسط نسخة، مكيّفة من مثالهم:

import base64
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="A ceramic mug of black coffee on an oak desk, morning window light, 35mm photo",
)

with open("generated_image.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))

نسخ الأمر النصي

تعود الصورة بصيغة base64 في interaction.output_image.data، لذلك تُفكّ شفرتها قبل كتابتها. تحصل على صورة 1K افتراضيًا، ومستوى التفكير يكون minimal افتراضيًا.

ضبط الحجم ونسبة العرض

وسيط response_format يتحكم في نوع المخرجات والنسبة والحجم:

interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="Overhead photo of a croissant on a linen placemat, soft window light",
    response_format={
        "type": "image",
        "mime_type": "image/jpeg",
        "aspect_ratio": "16:9",
        "image_size": "2K",
    },
)

نسخ الأمر النصي

للتعديلات اللاحقة، مرّر previous_interaction_id=interaction.id مع input جديد، فيعدّل النموذج النتيجة السابقة. في الأمر النصي الصعب يمكنك رفع مستوى الاستدلال عبر generation_config={"thinking_level": "high"}. راجع لوحة الفوترة بعد تشغيل تجريبي صغير قبل تفعيله في كل مكان.

إعادة المحاولة وتسجيل التكلفة

يحتاج الكود الإنتاجي إلى شيئين لا يملكهما المثال: التراجع عند الخطأ 429، وعداد تكلفة يعمل باستمرار.

import base64
import random
import time

from google import genai

client = genai.Client()

PRICE = {
    ("gemini-3.1-flash-lite-image", "1K"): 0.0336,
    ("gemini-3.1-flash-image", "1K"): 0.067,
    ("gemini-3.1-flash-image", "2K"): 0.101,
    ("gemini-3.1-flash-image", "4K"): 0.151,
    ("gemini-3-pro-image", "1K"): 0.134,
    ("gemini-3-pro-image", "2K"): 0.134,
    ("gemini-3-pro-image", "4K"): 0.24,
}

total = 0.0


def generate(prompt, model="gemini-3.1-flash-image", size="1K", ratio="16:9", retries=5):
    global total
    for attempt in range(retries):
        try:
            interaction = client.interactions.create(
                model=model,
                input=prompt,
                response_format={
                    "type": "image",
                    "mime_type": "image/jpeg",
                    "aspect_ratio": ratio,
                    "image_size": size,
                },
            )
            total += PRICE[(model, size)]
            return base64.b64decode(interaction.output_image.data)
        except Exception as err:
            if getattr(err, "code", None) != 429 or attempt == retries - 1:
                raise
            time.sleep(2 ** attempt + random.random())


image = generate("Overhead photo of a croissant on a linen placemat, soft window light")
with open("croissant.jpg", "wb") as f:
    f.write(image)
print(f"Spent so far: ${total:.3f}")

نسخ الأمر النصي

الأسعار في القاموس مأخوذة مباشرة من الجداول أعلاه، لذا حدّثها كلما غيّرت Google أسعارها. سجّل total بعد كل تشغيل، وستعرف الفاتورة قبل أن تصلك.

أمثلة على التكلفة الشهرية الفعلية

الأرقام أقوى من الصفات، لذا إليك الفواتير الشهرية عند حجمين. كل رقم هو عدد الصور مضروبًا في سعر الصورة المنشور، دون إضافات للتوكنات المدخلة أو الصور المرجعية.

1,000 صورة شهريًا

هنا يعيش كتالوج صغير أو مدونة نشطة. حتى أغلى صف يبقى عند $240، لذا عند هذا الحجم يكون اختيار النموذج متعلقًا بالجودة لا بالتكلفة. شهر كامل من Nano Banana 2 بدقة 2K يبلغ $101، أي أعلى قليلًا من خط $100 لمستوى Tier 2.

50,000 صورة شهريًا

عند هذا الحجم تتراكم الاختيارات. الفارق بين Lite في وضع الدفعات ($840) وPro بالأسعار القياسية ($6,700) هو $5,860 شهريًا، أي نحو ثمانية أضعاف. إنفاق $3,350 شهريًا يتجاوز خط $1,000 لمستوى Tier 3 خلال نحو تسعة أيام، لكن انتظار 30 يومًا ما زال ساريًا، لذا خطط لشهرك الأول وفق حدود Tier 2. حمل ثابت يبلغ نحو 1,700 صورة يوميًا يقع بعيدًا جدًا عن سقف $50 لعشر دقائق. الاندفاعات هي ما يفعّله.

استخدم Nano Banana 2 Lite على PicassoIA

قبل أن تنفق أموال API على تجارب الأوامر النصية، اختبرها حيث تكون التكرارات رخيصة. Nano Banana 2 Lite متاح على PicassoIA كنموذج سريع منخفض التكلفة لتحويل النص إلى صورة، مع تعديل الصور مدمج فيه.

1. افتح صفحة النموذج Nano Banana 2 Lite.
2. اكتب الأمر النصي. سمِّ الشخص، واتجاه الضوء، والعدسة، وملمس الأسطح.
3. أضف صورًا مرجعية إن احتجت إليها. يقبل إدخال الصور حتى 14 صورة للمزج أو لإعادة تصميمها بأسلوب جديد.
4. اختر نسبة العرض إلى الارتفاع. الافتراضي هو match_input_image. تتراوح الإعدادات المسبقة من 1:1 إلى 21:9، إضافة إلى النسب الطويلة والعريضة جدًا مثل 1:4 و4:1 و1:8 و8:1.
5. اختر jpg أو png كصيغة للمخرجات.
6. ولّد وقارن، واحتفظ بصياغة الأمر النصي الفائز لسكربت Python الخاص بك.

💡 نصيحة: الأوامر النصية التي تعمل جيدًا على النموذج المستضاف ينبغي أن تنتقل بدقة إلى واجهة API، مع أن النتائج لا تتطابق أبدًا بين المنصات. أجرِ عدة فحوصات جنبًا إلى جنب قبل التوسع.

إن كنت تكتب الأوامر النصية بالجملة، فإن Gemini 3.5 Flash على PicassoIA نموذج نصي سريع لكتابة تنويعات الأوامر. الاختبار هناك لا يمسّ حصتك في Gemini ولا فاتورة Google.

جرّب أوامرك النصية الخاصة على Picasso IA

جداول الأسعار لا تكفي وحدها. أسرع طريقة لمعرفة النموذج والحجم والنسبة المناسبين لمشروعك هي توليد بعض الصور والنظر إليها. افتح Picasso IA، وجرّب Nano Banana 2 Lite بأمر نصي من كتالوجك، ثم قارن النتيجة مع Nano Banana 2 وNano Banana Pro. تصفح قائمة النماذج الكاملة على picassoia.com/en/all-models، واختر المخرجات التي تعجبك، وانقل هذا الاختيار إلى ميزانية API مع أرقام حقيقية خلفه.