رفتن به محتوا

API مج · مدل تصویر

API مدل Nano Banana 2

متن شفاف و خوانا، تا 4K

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

در یک نگاه

API مدل Nano Banana 2، مدل 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حدود، به دلار

نگاه کلی

API مدل Nano Banana 2 چه کاری انجام می‌دهد

مدل‌های تصویر 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 را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی API مدل Nano Banana 2

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

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

سؤالات متداول

سؤالات متداول

هزینه API مدل Nano Banana 2 چقدر است؟
یک درخواست Nano Banana 2 با تنظیمات پیش‌فرض (Nano Banana 2.1) 51 Gems هزینه دارد، حدود $0.051. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت API مدل Nano Banana 2 چیست؟
POST https://api.mage.space/v1/nano_banana_v2/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل 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 استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Nano Banana 2 را با نام درخواست کنید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Nano Banana 2 تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.