انتقل إلى المحتوى

Mage API · نموذج صور

Nano Banana 2 API

نصوص واضحة ومقروءة بدقة تصل إلى 4K

POST https://api.mage.space/v1/nano_banana_v2/generate

لمحة سريعة

تشغّل واجهة Nano Banana 2 API نموذج Nano Banana 2.1 ونسخة أخرى عبر Mage من خلال POST https://api.mage.space/v1/nano_banana_v2/generate. يكلّف الطلب بالإعدادات الافتراضية 51 Gems (نحو 0.051 دولار) بدون أي اشتراك. يدعم Nano Banana 2 الشخصيات المحفوظة والمراجع عبر @handle داخل الوصف النصي.

  • صورةالمخرجات
  • 2الإصدارات
  • 51Gems لكل صورة، الافتراضي
  • $0.051التكلفة التقريبية بالدولار

نظرة عامة

ماذا تقدّم Nano Banana 2 API

نماذج الصور من Google لتصميم الرسومات والمحتوى التسويقي مع نصوص مقروءة. يتصدّر Nano Banana 2.1 هذه العائلة؛ وكلاهما يولّد الصور أو يعدّلها انطلاقًا من 14 صورة مرجعية كحد أقصى بدقة تصل إلى 4K. ينطبق مرشّح الأمان الخاص بـ Google.

نماذج Nano Banana من Google، لإنشاء رسومات بنصوص مقروءة وتعديلات انطلاقًا من 14 صورة مرجعية كحد أقصى، بدقة تصل إلى 4K. النموذج Nano Banana 2.1 (`nano-banana-v2.1`) هو الافتراضي وتكلفته أقل؛ أما Nano Banana 2 (`nano-banana-v2`) فيدعم أيضًا الإخراج بدقة 512. ينطبق مرشّح الأمان الخاص بـ Google.

يقبل الحقلين image وadditional_images كمدخلات.

بداية سريعة

استدعاء Nano Banana 2 API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /nano_banana_v2/generate، ثم تحقق من status_url بشكل متكرر حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/nano_banana_v2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "1:1",
  "model_id": "nano-banana-v2.1"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('nano_banana_v2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '1:1',
  model_id: 'nano-banana-v2.1',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("nano_banana_v2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "1:1",
    "model_id": "nano-banana-v2.1",
})

print(request["result"]["url"])

النماذج

قيم model_id لنموذج Nano Banana 2

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
nano-banana-v2Nano Banana 2
nano-banana-v2.1Nano Banana 2.1نعم

الخيارات

معلمات Nano Banana 2

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio1:1, 3:2, 2:3, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
resolution512, 1K, 2K, 4K

المدخلات

مدخلات الوسائط التي يقبلها Nano Banana 2

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.

المزيد من نماذج الصور

واجهات API أخرى لإنشاء الصور على Mage

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

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

كم تبلغ تكلفة Nano Banana 2 API؟
يكلّف طلب Nano Banana 2 بالإعدادات الافتراضية (Nano Banana 2.1) ‏51 Gems، أي نحو 0.051 دولار. تؤثر الدقة والمدة والنسخة المختارة في السعر، وتوضّح الاستجابة التكلفة الدقيقة. يُسترد المبلغ عند فشل عملية التوليد، ولا يُسترد إذا حجبتها سياسة المحتوى في Mage.
ما نقطة نهاية Nano Banana 2 API؟
أرسل طلب POST إلى https://api.mage.space/v1/nano_banana_v2/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. يتضمن الرد status_url لتتحقق منه بشكل متكرر حتى تظهر النتيجة.
ما نماذج Nano Banana 2 التي يمكنني استدعاؤها؟
nano-banana-v2 (Nano Banana 2)، وnano-banana-v2.1 (Nano Banana 2.1). النموذج الافتراضي هو Nano Banana 2.1.
هل يدعم Nano Banana 2 الصور المرجعية أو الشخصيات؟
يقبل Nano Banana 2 المعلمتين image وadditional_images. ويمكنك استخدام الشخصيات والمراجع المحفوظة عبر ذكر @handle في الوصف.
هل يمكنني استخدام Nano Banana 2 من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Nano Banana 2 بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
ما مدة الاحتفاظ بنتائج Nano Banana 2؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع