عملية الوصول الكاملة لـ Nano Banana 2 API: شرح مفصل لخطوات الشراء الرسمية، وتوصيات للحلول البديلة

ملاحظة من الكاتب: سنستعرض في هذا الدليل خطوات الشراء الكاملة للوصول الرسمي إلى Nano Banana 2 (عبر ربط البطاقة في AI Studio وتهيئة Vertex AI)، مع تحليل قيود الشبكة للمستخدمين خارج الولايات المتحدة، وكيف تعمل خدمة APIYI كحل بديل لضمان استمرارية العمل.

تحدثنا في المقال السابق عن الوصول إلى Nano Banana Pro، وفي هذا المقال سنتناول "شقيقه" Nano Banana 2 (الذي يحمل الاسم البرمجي gemini-3.1-flash-image-preview). على الرغم من أن كلاهما يعتمد على نموذج Gemini للصور، إلا أن عملية الوصول إلى NB2 تختلف قليلاً؛ ففي مارس 2026 قامت AI Studio بتحديث نظام الفوترة (نظام الدفع المسبق)، كما أن إعدادات Vertex AI تختلف أيضاً. سنمشي في هذا المقال خطوة بخطوة عبر عملية الشراء الرسمية، ثم سنوضح كيف توفر APIYI حلاً بديلاً يضمن لك "القدرة على الاتصال المباشر بالخدمة الرسمية" مع ضمان "عدم توقف أعمالك في حال تعطل الخدمة الرسمية أو تجاوز حدود الاستخدام".

القيمة الجوهرية: إتمام عملية الشراء الرسمية بالكامل، وفهم التكاليف والعوائق في كل خطوة، مع تجهيز APIYI كخطة بديلة لضمان استمرارية الأعمال.

المعلومات الأساسية للوصول الرسمي إلى Nano Banana 2 API

المسار الأول: الشراء والوصول عبر AI Studio (خطوات كاملة)

يُعد AI Studio الخيار الأول لمعظم المطورين، وقد شهد نظام الفوترة تحديثاً في مارس 2026، حيث انتقل من الفوترة المرتبطة بـ GCP إلى نظام الدفع المسبق/اللاحق المدمج داخل AI Studio.

الخطوة 1: إنشاء حساب Google وتسجيل الدخول إلى AI Studio

تنبيه للمستخدمين في الصين: ستحتاج إلى VPN للوصول إلى AI Studio. وحتى مع وجود VPN، قد تقوم Google بالتحقق من منطقة تسجيل الحساب؛ لذا يُنصح باستخدام حساب Gmail أمريكي.

الخطوة 2: إنشاء مفتاح API

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

الخطوة 3: ربط وسيلة الدفع وشحن الرصيد

بدءاً من 23 مارس 2026، اعتمد AI Studio نظام فوترة جديد:

خطوات شحن الرصيد المسبق:

1. الدخول إلى صفحة Billing في AI Studio.
2. النقر على "Buy Credits".
3. اختيار مبلغ الشحن (10 / 50 / 100 دولار أو مبلغ مخصص، بحد أقصى 5,000 دولار).
4. إدخال بيانات بطاقة الائتمان.

بطاقات الائتمان المدعومة: Visa، Mastercard، American Express، Discover، JCB.

عقبة للمستخدمين في الصين: يتطلب الأمر بطاقة ائتمان دولية. بطاقات "UnionPay" الصينية غير مقبولة. ستحتاج إلى بطاقة ائتمان دولية (Visa/Mastercard) أو استخدام خدمات البطاقات الائتمانية الافتراضية.

الخطوة 4: كتابة الكود لاستدعاء النموذج

from google import genai
from google.genai import types

# تهيئة العميل باستخدام مفتاح API الخاص بك
client = genai.Client(api_key="YOUR_AI_STUDIO_KEY")

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents=["كلب جولدن ريتريفر يركض على الشاطئ، شمس الظهيرة"],
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(
            image_size="4K",
            aspect_ratio="16:9"
        ),
    )
)

# حفظ الصورة الناتجة
for part in response.parts:
    if image := part.as_image():
        image.save("output.png", format="PNG")

الخطوة 5: مراقبة الاستهلاك والتكاليف

تستغرق العملية بأكملها حوالي 30-45 دقيقة (بما في ذلك وقت انتظار التحقق من بطاقة الائتمان).

المسار الثاني: الشراء والربط عبر Vertex AI (للمؤسسات)

تُعد منصة Vertex AI الخيار الأمثل للمستخدمين من الشركات التي تتطلب اتفاقيات مستوى الخدمة (SLA)، والتحكم في صلاحيات الوصول (IAM)، وشهادات الامتثال.

نظرة عامة على خطوات الربط عبر Vertex AI

إجمالي الوقت المستغرق حوالي 2-3 ساعات.

تسعير Vertex AI

التسعير مطابق تماماً لـ AI Studio، حيث تبلغ التكلفة 0.067 دولار لكل 2 ألف رمز (Token)، و0.151 دولار لكل 4 آلاف رمز. لا توجد خصومات.

القيمة المضافة التي توفرها Vertex AI هي: ضمان مستوى خدمة (SLA) بنسبة 99.9%، تحكم دقيق في صلاحيات IAM، عزل الشبكة عبر VPC، وإمكانية تخصيص حصص الاستدعاء في الدقيقة (RPM).

قيود الشبكة في Vertex AI

كما هو الحال مع AI Studio، لا يمكن للمستخدمين في الصين أو روسيا الاتصال مباشرة بـ aiplatform.googleapis.com. وعادةً ما يحتاج مستخدمو الشركات إلى نشر خادم وسيط في سنغافورة أو اليابان للعمل كوكيل (Proxy) لإعادة توجيه الطلبات.

خطة الطوارئ من APIYI: لماذا نحتاج إلى "نظام المسار المزدوج"؟

يسأل بعض المطورين: بما أن APIYI أرخص وأسهل، فلماذا نحتفظ بالاتصال المباشر الرسمي؟

سيناريوهات الاتصال المباشر الرسمي (للطوارئ)

سيناريوهات APIYI (للطوارئ – أكثر شيوعاً)

البنية الموصى بها: إعطاء الأولوية لـ APIYI (توفير + استقرار)، مع جعل الاتصال الرسمي كخيار احتياطي (بالطبع إذا تعطل الرسمي، فلا مفر من ذلك).

كود الربط مع APIYI (يختلف عن الكود الرسمي بسطر واحد فقط)

import openai

# ربط APIYI: تغيير سطر base_url فقط
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 openai

# الأساسي: APIYI (رخيص + مستقر)
apiyi_client = openai.OpenAI(
    api_key="APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# الاحتياطي: الاتصال المباشر الرسمي
from google import genai
official_client = genai.Client(api_key="GOOGLE_KEY")

def generate_image(prompt: str):
    """نظام المسار المزدوج: الأولوية لـ APIYI، ثم التدرج للرسمي عند الفشل"""
    try:
        # الخيار الأول: APIYI ($0.045/صورة، مستقر)
        response = apiyi_client.chat.completions.create(
            model="gemini-3.1-flash-image-preview",
            messages=[{"role": "user", "content": prompt}]
        )
        return response, "apiyi"
    except Exception as e:
        print(f"فشل APIYI: {e}، التبديل إلى الاتصال المباشر الرسمي...")
        try:
            # الاحتياطي: الاتصال المباشر الرسمي ($0.151/صورة)
            from google.genai import types
            response = official_client.models.generate_content(
                model="gemini-3.1-flash-image-preview",
                contents=[prompt],
                config=types.GenerateContentConfig(
                    response_modalities=["TEXT", "IMAGE"],
                ),
            )
            return response, "official"
        except Exception as e2:
            print(f"فشل الاتصال الرسمي أيضاً: {e2} (إذا تعطل الرسمي فلا حل)")
            return None, "both_failed"

🎯 نصيحة معمارية: استخدم APIYI في العمليات اليومية (توفير + استقرار)، مع الاحتفاظ بمسار الكود الرسمي. إذا تعطل APIYI انتقل للرسمي، وإذا تعطل الرسمي انتقل لـ APIYI — كلاهما يدعم الآخر، لضمان عدم انقطاع العمل أبداً (إلا في حال تعطل كلاهما معاً، فهذا يعني خللاً في البنية التحتية لـ Google، وهو أمر خارج عن الإرادة).

Nano Banana 2 مقابل Nano Banana Pro: فروقات الربط الرسمي

إذا كنت قد قرأت المقال السابق حول NB Pro، فإليك الفروقات الجوهرية للربط مع NB2:

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

الخلاصة

النقاط الجوهرية لربط واجهة برمجة تطبيقات Nano Banana 2:

1. المسار الرسمي يتطلب بطاقة ائتمان وسعراً كاملاً: AI Studio سهل الإعداد في 30 دقيقة لكنه يتطلب بطاقة دولية وسعراً كاملاً 0.151 دولار/صورة؛ Vertex AI يستغرق 2-3 ساعات لكنه يوفر اتفاقية مستوى الخدمة (SLA). كلاهما لا يمكن الاتصال به مباشرة من الصين/روسيا.
2. APIYI هو الحل الأمثل لضمان الاستمرارية وخفض التكاليف: إعداد في 5 دقائق، تكلفة 0.045 دولار لكل 4 آلاف رمز (خصم 72%)، اتصال عالمي مباشر، لا حاجة لبطاقة ائتمان دولية، دفع حسب الاستخدام، ولا يتم خصم رسوم عند الفشل. يلبي معظم احتياجات الأعمال.
3. هيكلية المسار المزدوج هي الأكثر أماناً: استخدم APIYI يومياً لتوفير التكاليف، واحتفظ بمسار الكود الرسمي كخطة احتياطية. كلاهما يعمل كنسخة احتياطية للآخر لضمان عدم توقف أعمالك أبداً (إذا تعطلت الخدمة الرسمية تماماً، فهذا أمر نادر جداً وخارج عن السيطرة).

نوصي بالاتصال عبر APIYI apiyi.com لاستخدام واجهة برمجة تطبيقات Nano Banana 2 — بسعر 0.045 دولار لكل 4 آلاف رمز، اتصال عالمي مباشر، إعداد في 5 دقائق، مع رصيد تجريبي مجاني عند التسجيل.

📚 المراجع

1. دليل المطور الرسمي لـ Nano Banana 2: دروس تعليمية من Google حول دمج واستخدام NB2

   • الرابط: blog.google/innovation-and-ai/technology/developers-tools/build-with-nano-banana-2/
   • الوصف: يتضمن قدرات النموذج، وأمثلة برمجية، وأفضل الممارسات.

2. وثائق فوترة AI Studio: نظام الفوترة الجديد (الدفع المسبق/الدفع الآجل)

   • الرابط: ai.google.dev/gemini-api/docs/billing
   • الوصف: شرح تفصيلي للنظام الجديد الصادر بتاريخ 23 مارس 2026.

3. حدود معدل استدعاء Gemini API: الحدود الرسمية ومستويات الاستخدام

   • الرابط: ai.google.dev/gemini-api/docs/rate-limits
   • الوصف: تفاصيل الحصص المحددة للمستوى المجاني، والمستوى 1، والمستوى 2، والمستوى 3.

4. مركز وثائق APIYI: دليل دمج Nano Banana 2 بسعر 0.045 دولار لكل 4 آلاف رمز (Token)

   • الرابط: docs.apiyi.com
   • الوصف: دمج في 5 دقائق + اتصال مباشر عالمي + فوترة حسب الاستخدام + عدم الخصم في حال فشل الطلب.

الكاتب: الفريق التقني لـ APIYI
النقاش التقني: نرحب بمشاركاتكم في قسم التعليقات، ولمزيد من المعلومات يمكنكم زيارة مركز وثائق APIYI على docs.apiyi.com.