حل قيود حجم إدخال نانو بانانا 2: صيغة حساب التوكن و 6 طرق لإصلاح خطأ 65536

عند استخدام Nano Banana 2 لتوليد الصور، قد تكون قد واجهت هذا الخطأ: The input token count exceeds the maximum number of tokens allowed (65536). هذا هو أحد أكثر الأخطاء شيوعًا التي يواجهها المطورون عند استدعاء واجهة برمجة تطبيقات Gemini لتوليد الصور — فبطاقة النموذج الرسمية تشير بوضوح إلى أن حد توكنات الإدخال هو 131,072، فلماذا يكون الحد الفعلي 65,536؟

القيمة الأساسية: بعد قراءة هذا المقال، ستفهم تمامًا حدود توكنات الإدخال والإخراج لـ Nano Banana 2، والصيغة الدقيقة لحساب توكنات الصور، و6 طرق عملية لحل خطأ 65536.

مواصفات نموذج Nano Banana 2: جدول المعلمات الكامل

معرف النموذج الأساسي لـ Nano Banana 2 هو gemini-3.1-flash-image-preview. فيما يلي المواصفات الكاملة المستخرجة من بطاقة النموذج الرسمية:

مصفوفة دعم وظائف Nano Banana 2

🎯 تذكير هام: لا يدعم Nano Banana 2 التخزين المؤقت (Caching) للسياق، مما يعني أن كل طلب يتطلب إعادة إرسال المحتوى الكامل للإدخال. بالنسبة للسيناريوهات التي تتضمن عددًا كبيرًا من الصور المرجعية، سيزيد هذا بشكل كبير من استهلاك التوكنات. عند الاستدعاء عبر منصة APIYI apiyi.com، يُنصح بتحسين محتوى الإدخال للتحكم في استخدام التوكنات لكل طلب.

قيود توكنات Nano Banana 2: السؤال الأساسي: 65536 أم 131072؟

هذا هو السؤال الأكثر إرباكًا للمطورين: تذكر الوثائق الرسمية 131,072، لكن الـ API يعيد خطأً يفيد بأن الحد الأقصى هو 65,536.

الحقيقة: اختلافات في سياسة المنصة، وليست اختلافات في قدرة النموذج

لماذا توجد اختلافات؟

يحتاج Nano Banana 2، كنموذج لتوليد الصور، إلى تخصيص كمية كبيرة من موارد الحوسبة لعملية تركيب الصور (رأس الانتشار). على عكس نماذج النصوص البحتة التي يمكنها استخدام سعة السياق الكاملة لفهم الإدخال، تحتاج نماذج توليد الصور إلى الحفاظ على خط أنابيب التوليد في نفس الوقت.

• يعتمد منطق Firebase AI حدًا أكثر تحفظًا يبلغ 65,536، ربما مع الأخذ في الاعتبار استقرار الأجهزة المحمولة والطرفية.
• يوفر Vertex AI / Google AI الحد الأقصى الكامل البالغ 131,072، وهو موجه لتطوير الخوادم والخدمات السحابية.

التأثير الفعلي: إذا كنت تستدعي عبر Gemini API القياسي وتلقيت خطأً يفيد بأن الحد الأقصى هو 65,536، فقد يكون السبب:

1. أن إصدار SDK الذي تستخدمه يمر افتراضيًا عبر قناة Firebase.
2. أن قيود المنصة خلال مرحلة المعاينة لم يتم توحيدها بعد.
3. قيود الحصص لمنطقة أو مستوى معين.

💡 نصيحة عملية: عند استدعاء Nano Banana 2 عبر منصة APIYI apiyi.com، يُنصح بالتحكم في توكنات الإدخال لتكون ضمن 65,536، لضمان عدم تجاوز الحد الأقصى بغض النظر عن المنصة التي يتم توجيه الطلب إليها. ستختار منصة APIYI تلقائيًا أفضل مسار للاستدعاء.

صيغة حساب توكنات صور الإدخال في Nano Banana 2

يُعد فهم كيفية تحويل الصور إلى توكنات أمرًا بالغ الأهمية لحل مشكلة حجم الإدخال. تستخدم Gemini استراتيجية التقطيع (Tiling) لحساب استهلاك التوكنات للصور.

قواعد الحساب الأساسية

القاعدة الأولى: الصور الصغيرة (كلا الجانبين ≤ 384 بكسل)

Token 消耗 = 258 tokens (固定值)
# استهلاك التوكنات = 258 توكن (قيمة ثابتة)

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

القاعدة الثانية: الصور الكبيرة (أي جانب > 384 بكسل)

Token 消耗 = ceil(width ÷ 768) × ceil(height ÷ 768) × 258
# استهلاك التوكنات = ceil(العرض ÷ 768) × ceil(الارتفاع ÷ 768) × 258

يتم تقسيم الصور الكبيرة إلى كتل (Tile) بحجم 768×768، وتستهلك كل كتلة 258 توكنًا.

جدول سريع لاستهلاك التوكنات لأحجام الصور الشائعة

التحكم في المعلمة media_resolution

تدعم نماذج Gemini 3 Series المعلمة media_resolution، والتي تتيح التحكم الدقيق في استهلاك التوكنات لكل صورة إدخال:

اكتشاف رئيسي: الإعداد الافتراضي HIGH يستهلك 1,120 توكن لكل صورة. إذا قمت بإدخال 14 صورة مرجعية (الحد الأقصى لـ Nano Banana 2) في طلب واحد، فإن الصور وحدها تستهلك 15,680 توكن — بالإضافة إلى موجه النص، مما يقترب بسهولة من حد 65,536.

تفاصيل استهلاك توكنات الإخراج في Nano Banana 2

يوجد أيضًا حد لتوكنات الإخراج: 32,768 توكن. تستهلك كل صورة يتم توليدها عددًا مختلفًا من توكنات الإخراج بناءً على دقتها:

الحد الأقصى للإخراج في طلب واحد

بناءً على حد توكنات الإخراج البالغ 32,768:

🚀 نصيحة للتوليد بكميات كبيرة: إذا كنت بحاجة إلى توليد عدد كبير من الصور، يُنصح باستخدام Batch API (خصم 50% على السعر) بدلاً من إدخال عدد كبير من الصور في طلب واحد. تدعم منصة APIYI apiyi.com استدعاء Batch API، حيث تكلف كل صورة 1K حوالي $0.015 فقط.

شرح تفصيلي لتنسيقات وقيود إدخال Nano Banana 2

تنسيقات الصور المدعومة للإدخال

قيود حجم الملف

قيود دقة صور الإدخال

• الحد الأقصى لدقة الإدخال: 3072×3072 بكسل
• الصور التي تتجاوز هذه الدقة سيتم تغيير حجمها تلقائيًا وبشكل متناسب لتصبح ضمن 3072×3072 بكسل.
• بعد تغيير الحجم، يتم الحفاظ على نسبة العرض إلى الارتفاع.

دعم إدخال ملفات PDF

يدعم Nano Banana 2 ملفات PDF كمدخلات، ولكن يجب الانتباه إلى استهلاك الـ Token:

• يتم التعامل مع كل صفحة PDF كصورة، وتستهلك نفس عدد الـ Token التي تستهلكها الصورة.
• بدقة HIGH (افتراضي)، تستهلك كل صفحة حوالي 1,120 Token.
• بحد أقصى 65,536 Token، يمكن دعم ما يصل إلى حوالي 58 صفحة من ملفات PDF.
• نصيحة: أدخل الصفحات المطلوبة فقط، ولا تقم بإدخال المستند بأكمله.

نسب العرض إلى الارتفاع المدعومة في Nano Banana 2

أضاف Nano Banana 2 العديد من نسب العرض إلى الارتفاع القصوى مقارنة بـ Nano Banana Pro:

💡 شرح النسب المضافة حديثًا: النسب القصوى الجديدة في Nano Banana 2، وهي 4:1، 1:4، 8:1، 1:8، مناسبة لإنشاء لافتات المواقع (Banner)، ورسوم بيانية معلوماتية طويلة، وصور جانبية، وغيرها من السيناريوهات الخاصة. يمكنك استخدام جميع هذه النسب مباشرة عبر منصة APIYI apiyi.com.

6 طرق لحل خطأ تجاوز حد التوكن 65536 في Nano Banana 2

6 طرق لحل خطأ 65536 توكن الفرز حسب التأثير ودرجة التوصية · الاستخدام المشترك يعطي أفضل النتائج

طريقة توفير التوكن صعوبة درجة التوصية شرح موجز

① خفض دقة الوسائط عالي→متوسط أو منخفض 50%-75% ↓ بسيط ★★★★★ تغيير معلمة واحدة

② تصغير حجم صورة الإدخال المعالجة المسبقة حتى ≤384px 75%+ انخفاض بسيط ★★★★★ 258 توكنز ثابتة

③ تقليل عدد الصور المرجعية 14 صورة → 3-5 صور تخفيض خطي بسيط ★★★★ قم بتحميل الصور الضرورية فقط

④ تقسيم الطلب معالجة دفعية للصور المتعددة / ملفات PDF الطويلة تجاوز القيود متوسط تفكير: المستخدم طلب ترجمة “★★★★”. هذه ليست كلمة أو عبارة قابلة للترجمة، بل هي رمز تقييم (أربع نجوم). في مثل هذه الحالات، يجب أن يبقى الرمز كما هو، لأنه يمثل نفس المعنى عالميًا.

إخراج: ★★★★ تعديل الكود مطلوب

⑤ استخدام Files API بديل base64 المضمن حوالي 33% انخفاض متوسط ★★★ تقليل تضخم جسم الطلب

⑥ تبسيط موجه النص 500 كلمة إلى 100 كلمة ~600 بسيط ★★★ التعبير الموجز أكثر فعالية

التركيبة الموصى بها: استخدام ① + ② + ③ في نفس الوقت · مصدر البيانات: فريق APIYI apiyi.com التقني

عندما تواجه خطأ The input token count exceeds the maximum number of tokens allowed (65536)، يمكن أن تساعدك الطرق الست التالية في حله:

الطريقة الأولى: خفض معلمة media_resolution (موصى بها)

التأثير: يقلل استهلاك التوكن بنسبة 50%-75%

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # واجهة APIYI الموحدة
)

# تقليل استهلاك التوكن عن طريق خفض دقة صور الإدخال
# HIGH (افتراضي) = 1,120 توكن/صورة
# MEDIUM = 560 توكن/صورة (تقليل 50%)
# LOW = 280 توكن/صورة (تقليل 75%)

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel("gemini-3.1-flash-image-preview")

# تحديد الدقة عند تحميل الصورة
image = genai.upload_file("input.jpg")

response = model.generate_content(
    contents=[
        "Edit this image to add a sunset background",
        image
    ],
    generation_config={
        "response_modalities": ["IMAGE", "TEXT"],
        "media_resolution": "MEDIUM"  # خفض من HIGH إلى MEDIUM
    }
)

# MEDIUM: 560 توكن/صورة (مقارنة بـ HIGH: 1,120 توكن/صورة)
# 14 صورة: 7,840 توكن (مقارنة بـ 15,680 توكن)

الطريقة الثانية: تصغير حجم صور الإدخال

التأثير: ضغط فائق إلى 258 توكن/صورة

قبل الإرسال إلى واجهة برمجة التطبيقات، قم بتصغير حجم الصورة المرجعية إلى 384×384 بكسل أو أقل:

from PIL import Image

def optimize_for_token(img_path, max_size=384):
    """تصغير حجم الصورة إلى 384 بكسل أو أقل، مع استهلاك توكن ثابت يبلغ 258"""
    img = Image.open(img_path)
    img.thumbnail((max_size, max_size), Image.LANCZOS)
    optimized_path = img_path.replace(".", "_optimized.")
    img.save(optimized_path, quality=85)
    return optimized_path

# قبل التحسين: 1024x1024 = 1,032 توكن
# بعد التحسين: 384x384 = 258 توكن (توفير 75%)

الطريقة الثالثة: تقليل عدد الصور المرجعية

التأثير: يقلل استهلاك التوكن خطيًا

يدعم Nano Banana 2 ما يصل إلى 14 صورة إدخال، لكن معظم السيناريوهات لا تتطلب هذا العدد الكبير:

نصيحة: قم بتمرير الصور المرجعية الضرورية فقط. في سيناريوهات اتساق الوجوه، عادةً ما تكون 2-3 صور كافية، ولا داعي لتمرير 14 صورة.

الطريقة الرابعة: تقسيم الطلبات

التأثير: يتجاوز حد الطلب الواحد

إذا كنت بحاجة إلى معالجة عدد كبير من الصور أو ملفات PDF طويلة، قم بتقسيم الطلب إلى عدة طلبات أصغر:

def split_process(images, prompt, batch_size=3):
    """تقسيم طلبات الصور المتعددة إلى دفعات صغيرة"""
    results = []
    for i in range(0, len(images), batch_size):
        batch = images[i:i+batch_size]
        response = client.images.generate(
            model="nano-banana-2",
            prompt=prompt,
            # تمرير عدد batch_size من الصور فقط في كل مرة
        )
        results.append(response)
    return results

الطريقة الخامسة: استخدام واجهة برمجة تطبيقات الملفات (Files API) بدلاً من base64 المضمنة

التأثير: يتجنب حجم الطلب الكبير، ويمكن تحميل ملفات أكبر

تشفير base64 المضمن يزيد من حجم الطلب بنسبة 33% تقريبًا. باستخدام Files API، يمكنك أولاً تحميل الملف للحصول على مرجع، ثم استخدامه في الطلب:

# استخدام Files API لتحميل الصور الكبيرة (تدعم 20-100 ميجابايت)
file = genai.upload_file("large_image.png")

# الإشارة إلى الملف في الطلب، بدلاً من تضمينه مباشرة
response = model.generate_content([
    "Based on this reference, generate a similar style image",
    file  # مرجع بدلاً من base64
])

الطريقة السادسة: تبسيط الموجهات النصية

التأثير: يحرر المزيد من التوكن للصور

لا تتجاهل أن الموجهات النصية تستهلك التوكن أيضًا. الموجهات الطويلة تستهلك جزءًا كبيرًا من ميزانية التوكن الثمينة:

• ❌ وصف مفصل من 500 كلمة ← ~750 توكن
• ✅ موجه موجز من 100 كلمة ← ~150 توكن
• التوفير: ~600 توكن، أي ما يعادل إضافة صورة واحدة بدقة MEDIUM

🎯 نصيحة شاملة: في التطوير العملي، نوصي بالجمع بين الطريقة الأولى + الطريقة الثانية + الطريقة الثالثة. عند استدعاء Nano Banana 2 عبر منصة APIYI apiyi.com، اضبط media_resolution على MEDIUM، وقم بمعالجة صور الإدخال مسبقًا إلى 384 بكسل، ومرر الصور المرجعية الضرورية فقط. بهذه الطريقة، يمكنك التحكم في استهلاك التوكن ليظل ضمن 5,000 توكن، بعيدًا عن حد 65,536.

مقارنة حدود التوكن لـ Nano Banana 2 والنماذج الأخرى

الاختلافات الرئيسية:

1. الحد الأقصى لتوكنات الإدخال في Nano Banana 2 أقل بكثير من Gemini 3 Flash النصي فقط (65 ألف مقابل 1 مليون)، وهذا يرجع إلى قيود بنية توليد الصور.
2. الحد الأقصى للإدخال في Nano Banana Pro (حوالي 200 ألف) أعلى من Nano Banana 2، وهو مناسب للتحرير المعقد الذي يتطلب سياقًا كبيرًا.
3. يستخدم Gemini 2.5 Flash Image نموذجًا مبسطًا بتوكنات ثابتة لكل صورة، ولا يتطلب حسابات توكنات معقدة.

أسئلة متكررة

ملخص

إن قيود توكنات Nano Banana 2 ليست مشكلة صعبة، بل هي آلية تتطلب الفهم. بإتقانك للنقاط التالية، ستتمكن من التعامل معها بسهولة:

1. الحد الأقصى للإدخال 65,536-131,072 — التخطيط بناءً على 65,536 هو الأكثر أمانًا.
2. حساب توكنات الصور — الصور الصغيرة 258 ثابتة، والصور الكبيرة تُقسم إلى كتل 768×768.
3. media_resolution هي الوسيلة الأكثر فعالية للتعديل — من HIGH إلى MEDIUM يخفضها بنسبة 50% مباشرة.
4. الحد الأقصى للإخراج 32,768 — بحد أقصى 43 صورة بدقة 512 بكسل أو 13 صورة بدقة 4K في المرة الواحدة.
5. 6 حلول — الاستخدام المشترك يعطي أفضل النتائج.

نوصي باستدعاء Nano Banana 2 عبر منصة APIYI apiyi.com للاستمتاع بقدرات النموذج الكاملة بسعر 0.03 دولار للصورة الواحدة. توفر المنصة إحصائيات مفصلة لاستخدام التوكن، مما يساعدك على تحسين كل استدعاء بدقة.

📝 المؤلف: فريق APIYI | فريق APIYI التقني
🔗 للتواصل التقني: قم بزيارة apiyi.com للحصول على دليل الوصول الكامل إلى Nano Banana 2
📅 تاريخ التحديث: 27 فبراير 2026