الدليل الشامل لوثائق تطوير Nano Banana 2: مقارنة بين حلين للوصول عبر API الرسمي و APIYI

ملاحظة المؤلف: دليل تطوير Nano Banana 2 (gemini-3.1-flash-image-preview) بالتفصيل، مع مقارنة بين API جوجل الرسمي ومنصة APIYI، يتضمن أمثلة برمجية كاملة، وتكوينات المعلمات، واستراتيجيات توفير التكلفة.

للمطورين الراغبين في استخدام Nano Banana 2، تتوفر الآن وثيقتان للتطوير يمكن الرجوع إليهما: وثائق جوجل الرسمية (ai.google.dev/gemini-api/docs/image-generation) ووثائق منصة APIYI (docs.apiyi.com/api-capabilities/nano-banana-2-image).

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

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

دليل مرجعي سريع للمعلمات الأساسية في مستندات تطوير Nano Banana 2

لنلقِ نظرة أولاً على أهم إعدادات المعلمات. هذه المعلمات موحدة بغض النظر عن طريقة الربط التي تستخدمها:

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

🎯 نصيحة تطويرية: النسب 1:4، 4:1، 1:8، 8:1 هي نسب عرض إلى ارتفاع حصرية لـ Nano Banana 2، ولا يدعمها Nano Banana Pro. إذا كان تطبيقك يحتاج إلى بنرات طويلة أو صور معلومات طولية، فيجب عليك استخدام gemini-3.1-flash-image-preview.

خيار ربط Nano Banana 2 (أ): واجهة برمجة تطبيقات جوجل الرسمية (Official API)

الاستدعاء الأساسي للـ API الرسمي

تستخدم واجهة برمجة تطبيقات جوجل الرسمية حزمة Google Gen AI SDK، وهي تدعم لغات Python و JavaScript و Go و Java و REST.

from google import genai
from google.genai import types

client = genai.Client()

# تحويل النص إلى صورة بشكل أساسي
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="قطة برتقالية تتدحرج في أوراق الخريف المتساقطة، ألوان دافئة",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

# استخراج الصورة المُولدة
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)

from google import genai
from google.genai import types

client = genai.Client()

# تكوين المعلمات الكامل: دقة 2K + شاشة عريضة 16:9 + وضع التفكير العالي (High)
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="غلاف التقرير السنوي لشركة تقنية، العنوان 'AI Vision 2026'، نغمات زرقاء داكنة، نمط بسيط",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
        thinking_config=types.ThinkingConfig(
            thinking_level="High",
            include_thoughts=True
        )
    )
)

# تحليل الاستجابة (بما في ذلك عملية التفكير Thinking)
for part in response.parts:
    if part.thought and part.text:
        print(f"[عملية التفكير] {part.text}")
    elif part.inline_data:
        with open("report_cover.png", "wb") as f:
            f.write(part.inline_data.data)
        print("تم حفظ الصورة")

التوليد المتصل بالإنترنت عبر Image Search في الـ API الرسمي

هذه ميزة حصرية لـ Nano Banana 2 – الحصول على مراجع بصرية حقيقية عبر بحث صور جوجل قبل التوليد:

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="أحدث طراز من تسلا موديل Y لعام 2026، فضي، متوقف في شارع بالمدينة",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        tools=[
            types.Tool(google_search=types.GoogleSearch(
                search_types=types.SearchTypes(
                    web_search=types.WebSearch(),
                    image_search=types.ImageSearch()
                )
            ))
        ]
    )
)

🎯 ملاحظة: التوليد المتصل بـ Image Search له متطلبات عرض – يجب توفير رابط قابل للنقر يؤدي إلى صفحة الويب الخاصة بالصورة المصدر. يتم احتساب رسوم رموز التفكير (Thinking tokens) سواء تم إرجاع عملية الاستدلال أم لا.

خيار الربط "ب" لنموذج Nano Banana 2: منصة APIYI

مزايا الربط عبر منصة APIYI

استدعاء منصة APIYI بتنسيق متوافق مع OpenAI

إذا كان لديك بالفعل كود برمجي يعتمد على OpenAI SDK، فكل ما تحتاجه هو تغيير سطرين فقط للربط مع Nano Banana 2:

import openai

client = openai.OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{"role": "user", "content": "لوحة مناظر طبيعية صينية بالحبر، تكوين مع مساحات فارغة، جبال بعيدة يحيط بها الضباب"}]
)

import requests
import base64

API_KEY = "YOUR_APIYI_KEY"

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "contents": [{"parts": [{"text": "ملصق ترويجي للتجارة الإلكترونية، عنوان كبير 'عروض الربيع'، طابع أحمر"}]}],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {
                "aspectRatio": "9:16",
                "imageSize": "2K"
            }
        }
    },
    timeout=300
).json()

# فك تشفير الصورة وحفظها
img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("poster.png", "wb") as f:
    f.write(base64.b64decode(img_data))
print("تم توليد الصورة بنجاح، التكلفة حوالي $0.03")

نصيحة: قم بالتسجيل عبر APIYI (apiyi.com) للحصول على مفتاح API والبدء في الاستدعاء. تدعم المنصة طريقتين للاستدعاء: التنسيق المتوافق مع OpenAI والتنسيق الأصلي من جوجل، ويمكن لمفتاح واحد التبديل بين جميع النماذج.

مقارنة الأسعار بين خطتي Nano Banana 2

مقارنة التكلفة الشهرية لـ Nano Banana 2 (1000 صورة يومياً)

سعر APIYI البالغ 0.03 دولار للطلب ليس فقط أرخص بنسبة 55% من السعر الرسمي القياسي، بل هو أقل حتى من نصف سعر Batch الرسمي (0.034 دولار) — والأهم من ذلك، أنه يوفر استجابة فورية (Real-time)، دون الحاجة لانتظار 24 ساعة للمعالجة غير المتزامنة.

🎯 خطة توفير التكاليف: من خلال استدعاء Nano Banana 2 عبر APIYI (apiyi.com)، ستحتاج فقط إلى 30 دولاراً لـ 1000 صورة يومياً، بتكلفة شهرية تبلغ 900 دولار. احصل على رصيد تجريبي مجاني عند التسجيل، ومفتاح API واحد يدعم Nano Banana 2 وPro ونماذج رئيسية أخرى في نفس الوقت.

دليل تطوير الميزات المتقدمة لـ Nano Banana 2

تحرير الصور عبر الحوار متعدد الجولات

يدعم Nano Banana 2 التعديل المستمر على نفس الصورة من خلال المحادثة:

# تحرير متعدد الجولات بتنسيق APIYI + OpenAI
messages = [
    {"role": "user", "content": "أنشئ شعار علامة تجارية بأسلوب بسيط، باللون الأزرق"},
    # متابعة التحرير بعد استلام نتيجة الجولة الأولى
    {"role": "assistant", "content": "[نتائج الجولة الأولى]"},
    {"role": "user", "content": "غير اللون إلى الأرجواني المتدرج، وأضف اسم الشركة 'TechFlow'"}
]

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=messages
)

توليد الصور المرجعية في Nano Banana 2

اختيار وضع التفكير (Thinking Mode) في Nano Banana 2

🎯 نصيحة للمطورين: يتم احتساب تكلفة رموز التفكير (Thinking tokens) سواء تم ضبط includeThoughts=true أم لا. إذا لم تكن بحاجة لمراجعة عملية الاستدلال، فاحتفظ بالقيمة الافتراضية false — لن يؤثر ذلك على جودة التوليد، بل سيمنع فقط إرجاع نص الاستدلال الوسيط.

مرجع سرعة التوليد في Nano Banana 2

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

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

ملخص

النقاط الأساسية في وثائق تطوير Nano Banana 2:

1. لكل من الخيارين مزاياه: توفر واجهة برمجة تطبيقات جوجل الرسمية الميزات الأكثر اكتمالاً (Image Search، Thinking، 14 صورة مرجعية)، بينما تقدم APIYI أقل سعر (0.03 دولار لكل عملية) وأسهل طريقة للربط.
2. سعر APIYI (0.03 دولار) يعادل 45% من السعر الرسمي: مع استجابة فورية، وهو أرخص حتى من سعر الدفعات (Batch) الرسمي المخفض للنصف (0.034 دولار)، دون الحاجة للانتظار لمدة 24 ساعة.
3. المعلمات الأساسية مشتركة: يمكن استخدام مستويات الدقة الأربعة، و14 نوعاً من نسب العرض إلى الارتفاع، ووضع التفكير (Thinking mode) وغيرها من المعلمات في كلا الخيارين.

بالنسبة لمعظم المطورين، نوصي بالربط السريع بـ Nano Banana 2 عبر APIYI apiyi.com — بسعر 0.03 دولار لكل عملية، وتنسيق متوافق مع OpenAI، ورصيد مجاني عند التسجيل، يمكنك توليد صورتك الأولى في غضون 5 دقائق.

📚 المصادر والمراجع

1. وثائق جوجل الرسمية لتوليد الصور عبر Gemini: مرجع API الكامل لنموذج Nano Banana 2

   • الرابط: ai.google.dev/gemini-api/docs/image-generation
   • الوصف: الوثائق الرسمية لجميع المعلمات، والوظائف، والميزات المتقدمة.

2. وثائق APIYI لنموذج Nano Banana 2: الوصول السريع وأمثلة الأكواد

   • الرابط: docs.apiyi.com/api-capabilities/nano-banana-2-image
   • الوصف: دليل الوصول لمنصة APIYI، يتضمن الأسعار وأمثلة استدعاء النموذج.

3. الأسعار الرسمية لـ Gemini API: الأسعار الدقيقة لكل دقة صورة

   • الرابط: ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview
   • الوصف: الأسعار القياسية وأسعار الدفعات (Batch) لدقات 0.5K/1K/2K/4K.

4. حدود معدل الاستخدام لـ Gemini API: قيود استدعاء نماذج المعاينة (Preview)

   • الرابط: ai.google.dev/gemini-api/docs/rate-limits
   • الوصف: تعرف على قيود الحصص (Quotas) لنماذج المعاينة.

المؤلف: الفريق التقني لـ APIYI
التواصل التقني: نرحب بمشاركة خبراتك في التطوير باستخدام Nano Banana 2 في قسم التعليقات. لمزيد من المعلومات حول نماذج الذكاء الاصطناعي، يمكنك زيارة مركز وثائق APIYI على docs.apiyi.com.