مفتاح Nano Banana API مجانًا: كيفية الحصول عليه وحدود الطبقة المجانية

يمكنك إنشاء توكن Nano Banana API مجانًا في نحو دقيقة. لكنك لا تستطيع استخدامه لتوليد الصور مجانًا. اعتبارًا من أكتوبر 2026، لا تدرج صفحة أسعار Google أي طبقة مجانية لأي نموذج من Nano Banana، لذلك تُحتسب كل صورة تُطلب عبر Gemini API منذ أول استدعاء. هذه الحقيقة وحدها تفسّر لماذا يرى كثير من المطورين خطأ 429 على توكن جديد يبدو صالحًا تمامًا.

يفصل هذا المقال بين ما هو مجاني وما ليس كذلك. ستجد فيه الخطوات الدقيقة لإنشاء التوكن، ومعرّف النموذج وسعر كل إصدار من Nano Banana، وثلاثة أمثلة للميزانية، وقواعد الحصص التي تقف خلف الأخطاء، والطرق المشروعة لتجربة النموذج دون دفع رسوم استدعاءات API. تم التحقق من كل رقم مقابل وثائق Google في أكتوبر 2026. الأسعار تتغير، لذا تحقق منها في صفحة الأسعار الرسمية قبل أن تحدد ميزانيتك.

💡 الإجابة السريعة: إنشاء التوكن مجاني. استدعاء Nano Banana عبر API يحتاج إلى حساب فوترة. تجربة Nano Banana دون فوترة تعني استخدام تطبيق أو أداة في المتصفح، لا API.

الإجابة المختصرة

كم يكلّف التوكن

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

فكّر فيه كبطاقة مكتبة لا تتضمن أي كتب. البطاقة مجانية، أما الرفوف التي خلفها، أي نماذج الصور، فمدفوعة.

كم تكلّف استدعاءات الصور

كل نموذج من Nano Banana مدفوع. يتراوح السعر من $0.0336 للصورة بدقة 1K على أخف النماذج، إلى $0.24 للصورة بدقة 4K على نموذج Pro. نماذج Google النصية تأتي فعلًا مع حصص مجانية وحدود يومية للطلبات، وهذه السمعة هي سبب وعد كثير من الدروس التعليمية بواجهة API مجانية للصور. هذا الوعد لا ينطبق على نماذج الصور.

النتيجة العملية بسيطة:

• توجد توكنات مجانية.
• توليد الصور المجاني عبر API غير موجود.
• التوليد المجاني عبر تطبيق أو أداة في المتصفح موجود.

توضح الأقسام التالية كل مسار بالترتيب.

يمكن أن تغيّر Google هذا في أي وقت، وقد تغيّرت الطبقات المجانية لعائلات نماذج أخرى من قبل. لا تعتمد على تاريخ الدرس التعليمي. افتح صفحة الأسعار، وابحث عن الصف الخاص بمعرّف النموذج الذي تنوي استدعاءه، واقرأ خانة الطبقة المجانية بنفسك. إذا أدرجت هذه الخانة حصة بدلًا من "غير متاح"، فستتغير النصيحة الواردة في هذا المقال معها.

ماذا يعني Nano Banana في API

Nano Banana هو الاسم المستعار لنماذج Gemini للصور من Google. يمتد الاسم المستعار الآن عبر عدة أجيال، ولكل جيل معرّف نموذج خاص به، وحد أقصى للدقة، وسعر. استدعاء المعرّف الخطأ هو أسرع طريقة لإنفاق أكثر من اللازم، لذلك يعرض الجدول النماذج جنبًا إلى جنب.

أربعة نماذج، أربعة معرّفات

تختلف حدود الدقة من نموذج إلى آخر. يقدّم Nano Banana 2 Lite دقة 1K فقط. يقدّم Nano Banana 2 دقة 512 بكسل (0.5K) و1K و2K و4K. يقدّم Nano Banana Pro دقة 1K و2K و4K. تقبل النماذج الثلاثة الأحدث حتى 14 صورة مرجعية، وكل صورة مولّدة تحمل علامة مائية SynthID.

أيّها يناسب ميزانيتك

• المسودات بكميات كبيرة: استخدم Nano Banana 2 Lite، بنحو 3.4 سنت للصورة بدقة 1K.
• العمل اليومي: استخدم Nano Banana 2، الذي يصل إلى دقة 4K ويقبل 14 صورة مرجعية، بسعر 6.7 سنت للصورة بدقة 1K.
• العمل النهائي: استخدم Nano Banana Pro، الذي تصفه Google بأنه "الخيار المتميز لأكثر المهام البصرية تعقيدًا". يكلّف بالضبط ضعف سعر Nano Banana 2 عند دقة 1K ($0.134 مقابل $0.067).
• الشيفرة القديمة: الاستدعاءات التي تستهدف المعرّف الأصلي تُحتسب بسعر $0.039 للصورة.

نمط عملي يعتمد على مرحلتين. أعدّ مسودة التكوين على Nano Banana 2 Lite أو بدقة 0.5K حتى يبدو الإطار والوضعية والإضاءة صحيحة. ثم أرسل الأمر النصي الفائز الوحيد، مع صوره المرجعية، إلى Nano Banana Pro للتصيير النهائي. تدفع السعر المتميز مرة واحدة لكل ناتج نهائي بدلًا من دفعه مرة لكل تجربة.

كيف تحصل على التوكن

أنشئه في Google AI Studio

1. افتح Google AI Studio وسجّل الدخول بحساب Google.
2. اقبل شروط الخدمة. يتم إنشاء مشروع Google Cloud افتراضي وتوكن لك.
3. افتح قائمة التوكنات وانسخ السلسلة النصية التي تخص المشروع الافتراضي.
4. احفظه في متغير بيئة. تقرأ حزم SDK الرسمية GEMINI_API_KEY أو GOOGLE_API_KEY، وإذا وُجدا معًا، يكون GOOGLE_API_KEY هو الذي له الأولوية.
5. تحقّق من الخطة المعروضة لذلك المشروع. المشروع بلا فوترة هو السبب الذي تفشل بسببه معظم استدعاءات الصور لاحقًا.

export GEMINI_API_KEY="paste-your-token-here"

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

يمكن لمعظم الناس البقاء في المشروع الافتراضي. لا يفيد مشروع ثانٍ إلا إذا أردت فوترة منفصلة وحدودًا منفصلة، مثلًا واحد لموقع عميل وآخر للتجارب الشخصية. تذكّر أن الحصص تتبع المشروع، لذا فإن توزيع العمل على عدة مشاريع يوزّع الفاتورة أيضًا.

شغّل أول اختبار لك

تعرض وثائق Google استدعاء Python بسيطًا كهذا. يقرأ العميل متغير البيئة بنفسه، لذلك لا تظهر أي سلسلة نصية في الشيفرة.

from google import genai
import base64

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="A ripe banana on a wooden desk, morning window light",
)
with open("banana.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))

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

في مشروع بلا فوترة، هذا هو الاستدعاء بالضبط الذي يفشل. وفي مشروع مربوط بالفوترة، يكتب banana.png ويُحتسب تقريبًا 6.7 سنت.

أبعده عن Git

تنصح Google المطورين بمعاملة التوكن كما يعاملون كلمة المرور. إذا تسرّب، يمكن لآخرين استهلاك حصتك وتراكم الرسوم على مشروعك.

• لا تُضِفه أبدًا إلى نظام إدارة الإصدارات.
• لا تضمّنه أبدًا داخل تطبيق ويب أو جوال، لأن الشيفرة المرسلة إلى المتصفح يمكن لأي شخص استخراجها.
• استدعِ API من خادم تتحكم فيه.
• إذا تسرّب، أنشئ بديلًا، وحدّث تطبيقك، وعطّل القديم، ثم راجع سجلات الاستخدام بحثًا عن استدعاءات لم تُجرِها.

لماذا تفشل الاستدعاءات المجانية

حاجز الفوترة

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

تحقّق من هذه النقاط بالترتيب:

1. حالة الفوترة: اربط حساب Cloud Billing بالمشروع الذي يملك التوكن.
2. معرّف النموذج: استخدم أحد المعرّفات الأربعة في الجدول أعلاه.
3. الصور في الدقيقة: تُحتسب نماذج الصور بوحدتها الخاصة، وهي موضحة أدناه.
4. إعادة الضبط اليومية: تبدأ العدادات من جديد عند منتصف الليل بتوقيت المحيط الهادئ.

ثلاث عادات تضيّع يومًا كاملًا من تصحيح الأخطاء:

• إنشاء توكنات إضافية داخل المشروع نفسه، على أمل الحصول على حصة جديدة.
• تبديل الشبكات أو نقاط اتصال VPN، وهذا لا يؤثر في حصة مرتبطة بمشروع.
• انتظار إعادة الضبط عند منتصف الليل، بينما العائق الفعلي هو حساب الفوترة غير الموجود.

أصلح الفوترة أولًا. ثم، إذا استمرت استجابات 429، تعامل معها كمشكلة في المعدل، وأبطئ حلقة الطلبات.

تُطبَّق حدود المعدل على كل مشروع

تقيس Google الاستخدام بعدد الطلبات في الدقيقة، والتوكنات في الدقيقة، والطلبات في اليوم. وتحسب النماذج التي تولّد الصور أيضًا الصور في الدقيقة (IPM)، وهي وحدة تعمل مثل التوكنات في الدقيقة. تُطبّق الحدود على المشروع، لا على التوكن، لذلك لا يضيف توكن ثانٍ داخل المشروع نفسه أي سعة.

لا تنشر صفحة حدود المعدل في Google أرقامًا ثابتة لنماذج الصور. وهي توجهك إلى AI Studio، حيث تُدرج حدودك الفعلية لكل مشروع. اقرأها هناك بدلًا من الوثوق بجدول في مدونة، بما في ذلك هذا الجدول.

💡 نصيحة: تُحتسب إعادة المحاولات مثل أي استدعاء آخر. أضف التراجع الأُسّي (exponential backoff) إلى شيفرتك حتى لا تتحول موجة من استجابات 429 إلى موجة من الرسوم.

التكلفة الحقيقية لكل صورة

السعر لكل صورة

الأسعار مأخوذة من صفحة أسعار Google في أكتوبر 2026.

ثلاثة أمثلة للميزانية

1. مدونة تضم 30 صورة مميزة شهريًا على Nano Banana 2 بدقة 1K: 30 x $0.067 = $2.01.
2. كتالوج منتجات يضم 2,000 صورة على Nano Banana 2 Lite: 2,000 x $0.0336 = $67.20.
3. مصمم يكرر العمل 40 مرة يوميًا لمدة 22 يوم عمل على Nano Banana Pro بدقة 2K: 880 x $0.134 = $117.92.

الحالة الثالثة هي التي تفاجئ الناس بفواتيرهم. كل إعادة توليد تُحتسب كصورة مدفوعة، لذلك يكلّف الأمر النصي الفضفاض أكثر من الأمر الدقيق. أعدّ المسودة بدقة 0.5K أو على نموذج Lite، ثم نفّذ تصيير الفائز مرة واحدة على Pro.

💡 نصيحة: أنشئ تنبيه ميزانية في Google Cloud Billing قبل أول استدعاء مدفوع. يستغرق الأمر دقيقتين، ويحذّرك قبل أن تُحدث حلقة خارجة عن السيطرة ضررًا.

طرق مجانية لتجربة Nano Banana

تطبيق Gemini

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

Nano Banana في المتصفح

يشغّل Picasso IA عدة نماذج صور من Google في المتصفح دون توكن ودون حساب Cloud. تذكر صفحة Nano Banana 2 أن التوليدات لا تخضع لحدود نقاط ولا لحصص استخدام. وتشمل العائلة نفسها أيضًا Nano Banana 2 Lite وNano Banana Pro وGemini 2.5 Flash Image.

إذا أردت مساعدة في كتابة الأوامر النصية أولًا، فإن نماذج الدردشة مثل Gemini 3.5 Flash تكتبها وتحسّنها في المكان نفسه.

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

كيف تستخدم Nano Banana 2 على Picasso IA

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

افتح النموذج والأمر النصي

1. افتح صفحة Nano Banana 2.
2. اكتب وصفًا في حقل Prompt. سمِّ الموضوع، والإضاءة، والعدسة، مثلًا "ضوء نافذة صباحي، 50mm، عمق ميدان ضحل".
3. اختر نسبة العرض إلى الارتفاع (aspect ratio). الافتراضي هو match_input_image، وتتراوح الإعدادات المسبقة من 1:1 و16:9 حتى 21:9، إضافة إلى 9:16 وتنسيقات طويلة مثل 1:4.
4. اختر الدقة (resolution) من 1K أو 2K أو 4K. الدقات الأعلى تستغرق وقتًا أطول.
5. اختر jpg أو png وشغّل التوليد.
6. اكتب تعليمة متابعة مثل "اجعل الخلفية أغمق" لتعديل النتيجة بدلًا من إعادة كتابة الأمر النصي.

الإعدادات المهمة

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

💡 نصيحة: ولّد ثلاث تنويعات بدقة 1K قبل أن تقضي وقتًا في تصيير بدقة 4K. معظم الأوامر النصية الضعيفة تظهر في أول صورة مصغرة.

ابدأ بتوليد صورك الأولى اليوم

أصبحت الآن تعرف الصورة الصادقة: التوكن مجاني، واستدعاءات API ليست كذلك، ومسار المتصفح يتجاوز المشكلتين. إذا كان هدفك أن ترى ما يستطيع Nano Banana فعله، فلست بحاجة إلى حساب فوترة للبدء. افتح Picasso IA، واختر Nano Banana 2 أو Nano Banana Pro، واكتب أول أمر نصي يخطر ببالك.

جرّب صورة منتج، أو بورتريه مع صور مرجعية، أو مشهدًا مرتكزًا إلى أخبار اليوم. ثم قارن النتائج بين النماذج في قائمة النماذج الكاملة. جرّب الإعدادات في الجدول أعلاه، واحتفظ بالأوامر النصية التي تعجبك، وابنِ مكتبة صغيرة لما ينجح. وعندما تكون مستعدًا للأتمتة، ستعرف مسبقًا أي نموذج ودقة يستحقان ميزانية API الخاصة بك. وقبل ذلك، ارجع إلى جدول الأسعار في هذا المقال، واحسب أرقامك بنفسك بالحجم الذي تتوقعه. تقدير شهري تقريبي يستغرق دقيقة واحدة، ويمنعك من مفاجأة غير سارة في أول فاتورة.