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-v2 | Nano Banana 2 | |
| nano-banana-v2.1 | Nano Banana 2.1 | بله |
گزینهها
پارامترهای 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
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
مدلهای تصویر بیشتر
سایر APIهای تولید تصویر در Mage
API مدل SDXL Plus
SDXL با چهره و دستهای اصلاحشده
Stable Diffusion v1.5 API
کلاسیک، با هزینهٔ کم
Stable Diffusion v3.5 Large API
Stable Diffusionای که بهتر از همه به حرف شما گوش میدهد
API مدل Stable Diffusion XL
SDXL بهینهشده برای تصاویر فوتورئال
API مدل Z-Image
سریعترین مدل تصویر در Mage
Anima API
ساختهشده مخصوص انیمه
سؤالات متداول
سؤالات متداول
هزینه API مدل Nano Banana 2 چقدر است؟
اندپوینت API مدل Nano Banana 2 چیست؟
کدام مدلهای Nano Banana 2 را میتوانم فراخوانی کنم؟
آیا Nano Banana 2 از تصاویر رفرنس یا شخصیتها پشتیبانی میکند؟
آیا میتوانم Nano Banana 2 را از Claude یا ChatGPT استفاده کنم؟
نتایج Nano Banana 2 تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.