Cara Menggunakan API Nano Banana 2.1

Google meluncurkan Nano Banana 2.1 pada 6 Oktober 2026, dan sudah dapat dipanggil melalui Gemini API sebagai gemini-nano-banana-2.1. Ini adalah pembaruan dari Nano Banana 2 (Gemini 3.1 Flash Image) dengan kualitas visual yang lebih baik, pengeditan gaya masker, dan konsistensi karakter yang lebih kuat antar giliran. Harganya juga setengah dari Nano Banana 2 per gambar pada setiap resolusi yang sama.

Panduan ini akan membawa Anda dari terminal kosong hingga gambar tersimpan, lalu membahas rasio aspek, output 2K dan 4K, pengeditan, perubahan multi-giliran, gambar referensi, pengaitan pencarian (search grounding), dan biaya. Setiap permintaan di bawah ini dapat disimpan dan diputar ulang di Apidog sehingga Anda dapat membandingkan 2.1 dengan model yang Anda gunakan saat ini.

Ingin latar belakangnya terlebih dahulu? Baca Apa Itu Nano Banana 2.1 untuk mengetahui apa yang berubah dan apa yang belum dipublikasikan Google.

Yang Anda butuhkan

Semua contoh menggunakan Interactions API, yang digunakan dalam dokumentasi pembuatan gambar Google untuk 2.1.

Langkah 1: Dapatkan kunci API Gemini

1. Buka Google AI Studio dan masuk.
2. Buka Dapatkan kunci API dan buat kunci di proyek Google Cloud.
3. Aktifkan penagihan untuk proyek tersebut. Halaman harga Google mencantumkan tingkat gratis untuk Nano Banana 2.1 sebagai “Tidak tersedia”, jadi panggilan API memerlukan proyek berbayar.
4. Ekspor kuncinya:

export GEMINI_API_KEY="your-key-here"

Google menghubungkan 2.1 ke AI Studio playground, yang berguna untuk menguji prompt, tetapi belum mempublikasikan berapa banyak akun gratis dapat menghasilkan di sana. Panduan kami tentang cara menggunakan Nano Banana 2.1 secara gratis membahas rute tersebut, dan mendapatkan kunci API Gemini menjelaskan penyiapan kunci secara lebih rinci.

Langkah 2: Hasilkan gambar pertama Anda

curl

curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {"type": "text", "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"}
    ]
  }'

Responsnya adalah JSON. Gambar datang sebagai data base64 di dalam blok konten gambar, jadi Anda akan memerlukan SDK (atau skrip) untuk mendekodenya.

Python

from google import genai
import base64

client = genai.Client()  # reads GEMINI_API_KEY

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
)

with open("generated_image.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))

interaction.output_image mengembalikan blok gambar yang terakhir dihasilkan. Bidang data-nya adalah base64, jadi dekode sebelum menulis file.

JavaScript

import { GoogleGenAI } from "@google/genai";
import * as fs from "node:fs";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-nano-banana-2.1",
  input: "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
});

const image = interaction.output_image;
if (image) {
  fs.writeFileSync("nano-banana.png", Buffer.from(image.data, "base64"));
}

Model gambar Gemini 3 berpikir sebelum menggambar. Model dapat menghasilkan hingga dua “gambar pemikiran” sementara (interim) saat merencanakan komposisi. Anda tidak dikenakan biaya untuk itu, dan fitur berpikir tidak dapat dimatikan di API.

Langkah 3: Atur rasio aspek, resolusi, dan output khusus gambar

Gunakan response_format untuk mengontrol output. Mengatur "type": "image" hanya mengembalikan gambar dan menghilangkan teks percakapan, yang membuat respons lebih kecil dan parsing lebih sederhana.

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="A product shot of a matte black coffee grinder on a marble counter",
    response_format={
        "type": "image",
        "mime_type": "image/png",
        "aspect_ratio": "16:9",
        "image_size": "2K",
    },
)

Hal-hal yang perlu diketahui:

• image_size menerima 1K, 2K, dan 4K. Gunakan K huruf besar; nilai huruf kecil seperti 2k ditolak.
• 2.1 tidak memiliki tingkat 512px. Itu milik Nano Banana 2.
• Rasio yang didukung meliputi 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, ditambah yang ekstrem 1:4, 4:1, 1:8, dan 8:1. Gambar 16:9 pada 2K adalah 2752x1536; pada 4K adalah 5504x3072.
• Jika Anda menginginkan teks dan gambar, berikan daftar: response_format=[{"type": "text"}, {"type": "image"}].

Langkah 4: Edit gambar yang sudah ada

Kirim gambar Anda sebagai blok `image` base64 di samping instruksi teks:

with open("living_room.png", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode("utf-8")

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=[
        {"type": "text", "text": "Using the provided image of a living room, change only the blue sofa to be a vintage, brown leather chesterfield sofa. Keep the rest of the room, including the pillows on the sofa and the lighting, unchanged."},
        {"type": "image", "data": image_b64, "mime_type": "image/png"},
    ],
)

Inpainting gaya masker tanpa file masker

Tidak ada unggahan masker terpisah. Anda mendefinisikan masker dalam kata-kata. Template Google:

Menggunakan gambar yang disediakan, ubah hanya [elemen spesifik] menjadi [elemen/deskripsi baru]. Pertahankan semua hal lain dalam gambar persis sama, dengan mempertahankan gaya, pencahayaan, dan komposisi asli.

Sebutkan satu elemen, jelaskan penggantiannya secara konkret, dan ulangi apa yang harus tetap. Prompt yang ambigu seperti “buat sofa lebih bagus” mengundang model untuk menggambar ulang seluruh ruangan.

Langkah 5: Iterasi dengan pengeditan multi-giliran

Multi-giliran adalah cara yang direkomendasikan Google untuk menyempurnakan gambar. Teruskan id interaksi sebelumnya sebagai previous_interaction_id dan kirim hanya perubahan yang Anda inginkan:

interaction_2 = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="Update this infographic to be in Spanish. Do not change any other elements of the image.",
    previous_interaction_id=interaction.id,
    response_format={"type": "image", "mime_type": "image/png", "aspect_ratio": "16:9", "image_size": "2K"},
)

Melalui REST, bidang yang sama masuk ke dalam body: "previous_interaction_id": "<PREVIOUS_INTERACTION_ID>". Di sinilah konsistensi karakter multi-giliran 2.1 yang ditingkatkan menjadi penting: karakter atau produk harus tetap dapat dikenali melalui beberapa putaran pengeditan.

Langkah 6: Gabungkan hingga 14 gambar referensi

Tambahkan lebih banyak blok image ke daftar input. Untuk 2.1, Google mendokumentasikan hingga 10 gambar objek dengan fidelitas tinggi dan hingga 4 gambar karakter, total 14:

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=[
        {"type": "text", "text": "An office group photo of these people, they are making funny faces."},
        {"type": "image", "data": person_1_b64, "mime_type": "image/png"},
        {"type": "image", "data": person_2_b64, "mime_type": "image/png"},
        {"type": "image", "data": person_3_b64, "mime_type": "image/png"},
    ],
    response_format={"type": "image", "aspect_ratio": "5:4", "image_size": "2K"},
)

Gambar referensi adalah token input, dan input 2.1 biayanya tiga kali lipat dari Nano Banana 2. Alur kerja referensi yang berat mempersempit kesenjangan harga, jadi ukur sebelum Anda beralih.

Langkah 7: Kaitkan gambar dengan Google Search

Untuk gambar yang bergantung pada fakta terkini, seperti grafik cuaca atau peristiwa terbaru, tambahkan alat pencarian:

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="A detailed painting of a Timareta butterfly resting on a flower",
    tools=[{"type": "google_search", "search_types": ["web_search", "image_search"]}],
)

{"type": "google_search"} saja memberi Anda pencarian web. Menambahkan image_search memungkinkan model menggunakan gambar web sebagai konteks visual, yang hanya didukung oleh 2.1 dan Nano Banana 2. Pengaitan gambar (Grounding) tidak dapat menggunakan gambar orang sungguhan dari pencarian. Jika Anda menampilkan hasil yang dikaitkan kepada pengguna, Google mengharuskan Anda menampilkan search_suggestions yang dikembalikan dalam langkah google_search_result.

Langkah 8: Uji di Apidog

Skrip bagus untuk pembuatan. Untuk memeriksa bahwa prompt, kunci, dan model masih berfungsi, permintaan yang disimpan lebih cepat. Di Apidog:

1. Buat lingkungan dan tambahkan variabel GEMINI_API_KEY dengan kunci Anda.
2. Buat permintaan: POST https://generativelanguage.googleapis.com/v1beta/interactions.
3. Tambahkan header x-goog-api-key: {{GEMINI_API_KEY}}.
4. Tempel body JSON dengan model, input, dan response_format, lalu klik Kirim.
5. Tambahkan skrip pasca-respons dengan dua pernyataan (assertions):

pm.test("status is 200", () => {
  pm.response.to.have.status(200);
});

pm.test("response contains an image block", () => {
  const steps = pm.response.json().steps || [];
  const hasImage = steps.some(s =>
    s.type === "model_output" &&
    (s.content || []).some(c => c.type === "image" && c.data)
  );
  pm.expect(hasImage).to.be.true;
});

6. Duplikat permintaan dan ubah model menjadi gemini-3.1-flash-image. Kirim keduanya dengan prompt yang sama.

Sekarang Anda memiliki perbandingan berdampingan 2.1 dengan Nano Banana 2, dengan status, waktu, dan ukuran respons yang ditampilkan untuk setiap eksekusi. Untuk perbandingan fitur yang lebih luas, lihat Nano Banana 2.1 vs Nano Banana 2 vs Pro.

Biayanya

Tingkat berbayar, sesuai halaman harga Google pada 7 Oktober 2026:

Output gambar untuk 2.1 adalah $30 per 1 juta token. Gambar 1K adalah 1.120 token, 2K adalah 1.680, dan 4K adalah 2.520, dari sinilah harga per gambar berasal. Output teks dan pemikiran adalah $7,50 per 1 juta. Pengaitan pencarian (Search grounding) mencakup 5.000 permintaan gratis per bulan yang dibagikan di seluruh model Gemini 3.x, kemudian $14 per 1.000.

Contoh kasus: 1.000 gambar produk pada 2K dari prompt teks pendek (sekitar 100 token input masing-masing).

• Output: 1.000 x $0,0504 = $50,40
• Input: 100.000 token x $1,50 / 1 Juta = $0,15
• Total: sekitar $50,55, ditambah token teks pemikiran apa pun

Pekerjaan yang sama di Nano Banana 2 berharga sekitar $101. Melalui Batch API, harga 2K untuk 2.1 turun menjadi $0,0252, jadi sisi output turun menjadi $25,20 jika Anda bisa menunggu. Pekerjaan batch menukarkan waktu penyelesaian hingga 24 jam dengan batas kecepatan yang lebih tinggi. Detail lebih lanjut tentang harga Nano Banana 2 ada di rincian harga API Nano Banana 2 kami.

Kesalahan umum

Ini adalah perilaku API Gemini umum, bukan kesalahan spesifik 2.1 yang didokumentasikan:

FAQ

Apakah ada tingkat gratis untuk API Nano Banana 2.1? Tidak. Google mencantumkan tingkat gratis API sebagai “Tidak tersedia”. AI Studio playground terhubung ke 2.1, tetapi Google belum mempublikasikan batas gratis untuknya.

Apakah 2.1 pengganti langsung untuk Nano Banana 2? Sebagian besar. Tukar ID model ke gemini-nano-banana-2.1. Anda kehilangan tingkat 512px, dan token input biayanya lebih mahal, jadi pengeditan yang banyak menggunakan referensi memerlukan pemeriksaan biaya.

Apakah gambar yang dihasilkan membawa watermark? Ya. Semua output menyertakan watermark SynthID.

Bisakah saya menghasilkan gambar dari video? Ya. 2.1 menerima blok input video, seperti URL YouTube, di samping prompt teks Anda.

Apakah panduan API Nano Banana 2 yang lama masih berlaku? Konsepnya berlaku. Lihat panduan API Nano Banana 2 kami untuk model sebelumnya.

Ringkasan

Nano Banana 2.1 menjanjikan gambar yang lebih baik dengan setengah harga per gambar Nano Banana 2, dengan bentuk Interactions API yang sama. Dapatkan kunci berbayar, hasilkan satu gambar, lalu simpan permintaan di Apidog dengan status dan pernyataan gambar. Duplikat dengan ID model lama, dan Anda akan tahu dalam sehari apakah 2.1 layak untuk beralih untuk prompt Anda.