لمحة سريعة
تشغّل Nano Banana 2 API نموذج Nano Banana 2 عبر Mage على POST https://api.mage.space/v1/nano_banana_v2/generate. يكلّف الطلب بالإعدادات الافتراضية 68 Gem (نحو 0.068 دولار) بدون اشتراك. يقبل Nano Banana 2 الشخصيات المحفوظة والمراجع عبر @handle في الوصف النصي.
صورة
المخرجات
1
النسخة
68
Gems لكل صورة، الافتراضي
$0.068
التكلفة التقريبية بالدولار
نظرة عامة
ماذا تقدّم Nano Banana 2 API
نموذج الصور من Google للرسومات والمحتوى التسويقي ذي النصوص المقروءة. يولّد الصور أو يعدّلها انطلاقًا من 14 صورة مرجعية كحد أقصى بدقة تصل إلى 4K. يُطبَّق مرشح الأمان من Google.
نموذج Nano Banana 2 من Google، للرسومات ذات النصوص المقروءة والتعديل انطلاقًا من 14 صورة مرجعية كحد أقصى، بدقة تصل إلى 4K. يُطبَّق مرشح الأمان من 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"
}' | 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',
});
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",
})
print(request["result"]["url"])النماذج
قيم model_id لنموذج Nano Banana 2
أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.
| model_id | الاسم | افتراضي |
|---|---|---|
| nano-banana-v2 | Nano Banana 2 | نعم |
الخيارات
معلمات Nano Banana 2
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 1:1, 3:2, 2:3, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 |
| resolution | 512, 1K, 2K, 4K |
المدخلات
مدخلات الوسائط التي يقبلها Nano Banana 2
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
المزيد من نماذج الصور
واجهات API أخرى لإنشاء الصور على Mage
صورة · ابتداءً من 15 Gems
SDXL Plus API
SDXL بوجوه وأيدٍ مصحّحة
صورة · من 10 Gems
Stable Diffusion v1.5 API
النموذج الكلاسيكي بتكلفة منخفضة
صورة · من 10 Gems
Stable Diffusion v3.5 Large API
نسخة Stable Diffusion الأكثر التزامًا بالوصف
صورة · من 10 Gems
واجهة Stable Diffusion XL API
نموذج SDXL مضبوط للواقعية الفوتوغرافية
صورة · من 10 Gems
واجهة Z-Image API
أسرع نموذج صور على Mage
صورة · من 20 Gem
Anima API
مصمم خصيصًا للأنمي
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Nano Banana 2 API؟
يكلّف طلب Nano Banana 2 بالإعدادات الافتراضية (Nano Banana 2) 68 Gems، أي نحو $0.068. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، ويعرض الرد المبلغ المحتسب بدقة. يُسترد المبلغ عند فشل التوليد، أما التوليد الذي تحظره سياسة المحتوى في 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 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.