Mage API · 圖片模型
Nano Banana 2 API
文字清晰易讀,最高 4K
POST https://api.mage.space/v1/nano_banana_v2/generate重點速覽
Nano Banana 2 API 透過 Mage 的 POST https://api.mage.space/v1/nano_banana_v2/generate 執行 Nano Banana 2.1 及另 1 個版本。以預設設定發送一次請求費用為 51 Gems(約 $0.051),無需訂閱。Nano Banana 2 支援已儲存的角色,可在提示詞中用 @handle 引用參考圖。
- 圖片輸出
- 2版本
- 51每張圖片所需 Gems(預設)
- $0.051約合美元
總覽
Nano Banana 2 API 能做什麼
Google 的圖像模型,適合製作含清晰文字的圖形與行銷內容。Nano Banana 2.1 是這個系列的首選;兩者都能以最多 14 張參考圖片生成或編輯,解析度最高可達 4K。適用 Google 的安全過濾機制。
Google 的 Nano Banana 模型,適合製作文字清晰易讀的圖形,並可根據最多 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"])模型
Nano Banana 2 的 model_id 值
傳入 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 支援的媒體輸入
每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。
| 欄位 | 用途 |
|---|---|
| image | 參考圖片。 |
| additional_images | 其他參考圖片。 |
更多圖片模型
Mage 上的其他圖片生成 API
SDXL Plus API
修正臉部與手部的 SDXL
Seedream API
Seedream,內建嚴格過濾
Stable Diffusion v1.5 API
經典之作,經濟實惠
Stable Diffusion v3.5 Large API
最聽話的 Stable Diffusion
Stable Diffusion XL API
針對寫實風格調校的 SDXL
Z-Image API
Mage 上最快的圖片模型
常見問題
常見問題
Nano Banana 2 API 的費用是多少?
Nano Banana 2 API 的端點是什麼?
我可以呼叫哪些 Nano Banana 2 模型?
Nano Banana 2 支援參考圖片或角色嗎?
我可以在 Claude 或 ChatGPT 中使用 Nano Banana 2 嗎?
Nano Banana 2 的生成結果會保存多久?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。