Langsung ke konten

Mage API · Model gambar

API Nano Banana 2

Teks tajam dan mudah dibaca, hingga 4K

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

Sekilas info

API Nano Banana 2 menjalankan Nano Banana 2.1 dan 1 varian lainnya lewat Mage di POST https://api.mage.space/v1/nano_banana_v2/generate. Satu permintaan dengan pengaturan default berharga 51 Gems (sekitar $0,051), tanpa langganan. Nano Banana 2 mendukung karakter yang tersimpan dan referensi lewat @handle di dalam prompt.

  • GambarOutput
  • 2Varian
  • 51Gems per gambar, default
  • $0.051Perkiraan, dalam USD

Ringkasan

Fungsi API Nano Banana 2

Model gambar Google untuk grafis dan konten pemasaran dengan teks yang terbaca jelas. Nano Banana 2.1 jadi andalan di keluarga ini; keduanya bisa membuat atau mengedit gambar dari hingga 14 gambar referensi dalam resolusi hingga 4K. Filter keamanan Google berlaku.

Model Nano Banana dari Google, untuk grafis dengan teks yang mudah dibaca dan pengeditan dari hingga 14 gambar referensi, hingga 4K. Nano Banana 2.1 (`nano-banana-v2.1`), yang jadi default, lebih murah; Nano Banana 2 (`nano-banana-v2`) juga bisa merender di 512. Filter keamanan Google berlaku.

Menerima image dan additional_images sebagai input.

Mulai cepat

Panggil API Nano Banana 2

Atur MAGE_API_KEY, kirim ke /nano_banana_v2/generate, lalu polling status_url sampai permintaan selesai.

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

Nilai model_id Nano Banana 2

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

model_idNamaDefault
nano-banana-v2Nano Banana 2
nano-banana-v2.1Nano Banana 2.1Ya

Opsi

Parameter Nano Banana 2

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

KolomNilai
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

Input

Input media yang didukung Nano Banana 2

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

KolomPeran
imageGambar referensi.
additional_imagesGambar referensi tambahan.

Model gambar lainnya

API pembuat gambar lainnya di Mage

FAQ

Pertanyaan yang sering diajukan

Berapa biaya API Nano Banana 2?
Satu permintaan Nano Banana 2 dengan pengaturan default (Nano Banana 2.1) berharga 51 Gems, sekitar $0,051. Resolusi, durasi, dan varian lain bisa mengubah harga; biaya pastinya tercantum di respons. Pembuatan yang gagal akan dikembalikan biayanya, tetapi yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint API Nano Banana 2?
POST https://api.mage.space/v1/nano_banana_v2/generate dengan header Authorization: Bearer yang berisi API key Mage kamu. Respons menyertakan status_url untuk di-polling guna mendapatkan hasilnya.
Model Nano Banana 2 apa saja yang bisa dipanggil?
nano-banana-v2 (Nano Banana 2), nano-banana-v2.1 (Nano Banana 2.1). Defaultnya adalah Nano Banana 2.1.
Apakah Nano Banana 2 mendukung gambar referensi atau karakter?
Nano Banana 2 menerima image, additional_images. Nano Banana 2 juga menerima karakter dan referensi tersimpan lewat @handle di prompt.
Bisakah aku memakai Nano Banana 2 dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Nano Banana 2 dengan menyebut namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harga sebelum membuat.
Berapa lama hasil Nano Banana 2 disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

CharactersKomunitas