Bagaimana cara menggunakan Nano Banana 2.1 API? Pembuatan & Pengeditan

TLDR Nano Banana 2.1 (gemini-nano-banana-2.1) sebagai model generasi gambar dan penyuntingan percakapan ber-efisiensi tinggi yang diperbarui dalam keluarga Gemini. Dibangun di atas Gemini 3.6 Flash, model ini menghadirkan peningkatan kualitas visual dan realisme (1K/2K/4K), perbaikan artefak tiling pada rasio aspek ekstrem, perenderan teks dan tata letak infografis yang unggul, penggabungan multi-gambar (hingga 14 referensi dengan konsistensi hingga 4 karakter dan 10 objek), grounding Google Search/Image Search, serta tingkat “thinking” yang dapat dikonfigurasi (minimal/medium/high).

Model ini diposisikan sebagai padanan efisien dari Nano Banana Pro sekaligus menawarkan kira-kira separuh biaya per gambar dibanding pendahulunya Nano Banana 2 pada banyak resolusi. Harga resmi dimulai sekitar $0.0336 per 1K gambar (tingkat Standar). Akses melalui Gemini API (Interactions API direkomendasikan), Google AI Studio, atau agregator terpadu seperti CometAPI untuk satu key yang kompatibel dengan OpenAI, integrasi yang disederhanakan, dan tarif kompetitif. Panduan ini mencakup penyiapan, contoh kode, fitur lanjutan, perbandingan harga, praktik terbaik, dan rekomendasi produksi.

Poin-Poin Utama

• Nano Banana 2.1 adalah model terbaru Google untuk generasi gambar dan penyuntingan percakapan ber-efisiensi tinggi, diposisikan sebagai padanan efisien untuk Nano Banana Pro.
• Uji internal Google menunjukkan skor 1050 Elo pada preferensi teks-ke-gambar secara keseluruhan (vs. 990 untuk Nano Banana 2 dan 935 untuk Pro) serta peningkatan kuat pada konsistensi dan penyuntingan.
• Harga mulai sekitar ~$0.0336 per gambar standar 1K melalui Gemini API—sekitar setengah dari Nano Banana 2.
• Mendukung hingga 14 gambar referensi, konsistensi 4 karakter + 10 objek, rasio panoramik tanpa artefak tiling, dan grounding pencarian web/gambar real-time.
• Nano Banana 2 dijadwalkan untuk penghentian pada 29 Oktober 2026; segera lakukan migrasi.
• Untuk pengembang, platform seperti CometAPI menawarkan satu endpoint yang kompatibel dengan OpenAI untuk mengakses Nano Banana 2.1 bersama 500+ model lain dengan satu key dan tarif kompetitif.

Apa itu Nano Banana 2.1?

Nano Banana 2.1 adalah anggota terbaru dari seri Gemini 3 milik Google DeepMind yang secara native multimodal untuk penalaran. Secara resmi berbasis Gemini 3.6 Flash, model ini mengkhususkan diri pada generasi gambar berkualitas tinggi dari teks dan penyuntingan gambar secara percakapan.

Model ini menerima masukan teks, gambar, video, dan PDF (jendela konteks hingga ~1M token di beberapa dokumentasi, atau 131.072 dalam spesifikasi API) dan menghasilkan gambar (hingga 4K) serta teks. Semua gambar yang dihasilkan memiliki tanda air SynthID dari Google.

Google menggambarkannya sebagai pembaruan atas Nano Banana 2 (Gemini 3.1 Flash Image) yang mempertahankan kecepatan dan biaya setara Flash sambil menghadirkan peningkatan signifikan dalam kualitas visual, kepatuhan terhadap prompt, konsistensi karakter multi-giliran, dan perenderan teks. Model ini secara eksplisit diposisikan sebagai “padanan yang lebih efisien” dari model tingkat lebih tinggi Nano Banana Pro (Gemini 3 Pro Image).

Kinerja Benchmark Nano Banana 2.1

Google mempublikasikan hasil preferensi manusia berdampingan (Elo) dan faktualitas internal per Oktober 2026. Perlu dicatat bahwa pengujian independen pihak ketiga terbatas pada saat peluncuran.

Kapabilitas Teks-ke-Gambar

Kapabilitas Penyuntingan

Sumber: Google DeepMind Nano Banana 2.1 Model Card.

Elo yang lebih tinggi menunjukkan preferensi manusia yang lebih kuat. Skor faktualitas (semakin tinggi semakin baik) menunjukkan lompatan besar khususnya untuk infografis yang akurat. Hasil ini memposisikan Nano Banana 2.1 sebagai model gambar tingkat Flash terkuat Google hingga saat ini dan kompetitif (atau unggul) dibanding Pro pada banyak aspek praktis dengan biaya dan latensi lebih rendah.

Harga Resmi Nano Banana 2.1 dan Pertimbangan Biaya (awal Oktober 2026)

Harga rujukan berbayar Standard Google (per keluaran gambar, sebelum token input/thinking/teks tambahan) kurang lebih:

Token input tercantum sekitar $1.50 per 1M; keluaran teks + thinking sekitar $7.50 per 1M dalam beberapa rincian. Tidak ada tier API gratis untuk model ini. Biaya akhir yang ditagihkan bergantung pada panjang prompt, jumlah gambar referensi, tingkat thinking, resolusi, dan keluaran teks tambahan.

Dibandingkan Nano Banana 2, biaya per gambar kurang lebih setengah pada resolusi setara, sehingga generasi volume lebih ekonomis. Nano Banana Pro tetap secara signifikan lebih mahal untuk kebutuhan fidelitas maksimum. Selalu verifikasi halaman harga Gemini API yang aktif, karena tarif dan perhitungan token dapat berubah.

CometAPI, misalnya, dengan cepat menambahkan dukungan untuk gemini-nano-banana-2.1 dan menyediakan akses terpadu dengan tarif kompetitif dan satu key di ratusan model.

Cara Mengakses dan Menyiapkan API Nano Banana 2.1

Model ID: gemini-nano-banana-2.1

Gunakan Interactions API modern atau endpoint generateContent dengan SDK google-genai.

Dengan gambar referensi dan resolusi/thinking lebih tinggi: Sertakan gambar yang di-base64 pada daftar input dan tetapkan opsi format respons untuk rasio aspek dan ukuran gambar (1K/2K/4K). Aktifkan tools untuk grounding Google Search saat akurasi fakta penting.

1. Google Gemini API resmi (direkomendasikan untuk paritas fitur penuh)

• Buat atau gunakan proyek Google AI Studio / Google Cloud dengan penagihan aktif.
• Dapatkan API key dari Google AI Studio.
• Instal SDK resmi: pip install -U google-genai (Python) atau setara untuk JavaScript/Node (@google/genai).
• Antarmuka modern yang direkomendasikan: Interactions API (client.interactions.create). GenerateContent legacy masih tersedia dalam beberapa konteks.
• Pola endpoint dasar: https://generativelanguage.googleapis.com/v1beta/interactions (atau path generateContent spesifik model). Autentikasi via header x-goog-api-key atau variabel lingkungan SDK GEMINI_API_KEY.

2. Google AI Studio

Ideal untuk prototyping cepat, pengujian prompt, dan inspeksi visual sebelum menulis kode. Pilih model dan bereksperimen dengan referensi, resolusi, dan tingkat thinking.

3. Agregator Terpadu (rekomendasi CometAPI)

CometAPI menawarkan satu endpoint yang kompatibel dengan OpenAI (https://api.cometapi.com/v1) dan satu API key untuk 500+ model, termasuk seri Gemini Nano Banana. Mendukung penetapan harga pay-as-you-go (sering kali dengan penghematan dibanding tarif vendor langsung), dasbor penggunaan, dan kompatibilitas SDK drop-in. Ini sangat berguna jika Anda sudah menggunakan banyak penyedia atau ingin melakukan A/B test model gambar tanpa mengelola kredensial dan penagihan terpisah. Daftar di CometAPI.com untuk kredit uji gratis, buat key, dan arahkan klien yang kompatibel dengan OpenAI ke base URL CometAPI. Model ID tetap gemini-nano-banana-2.1 .

Untuk CometAPI, tukar base URL dan key sambil mempertahankan struktur klien yang kompatibel dengan OpenAI atau Gemini. CometAPI menggunakan pola endpoint GenerateContent untuk mengakses nano Banana 2.1.

Perbandingan Rute Akses API Nano Banana 2.1

Pilih penyedia sebelum menyalin kode. Google menawarkan alur Interactions langsung yang digunakan pada contoh Python di bawah. Nano Banana 2.1 API di CometAPI menyediakan rute gateway yang digunakan pada contoh cURL. Bandingkan autentikasi, field input, penanganan output, dan state percakapan sebagai integrasi lengkap; key berasal dari akun dan sistem penagihan terpisah.

Contoh Google di bawah menggunakan Interactions API. Ini bukan permintaan untuk endpoint generateContent CometAPI. Ikuti ikhtisar Interactions Google untuk state interaksi dan penanganan respons. Contoh telah diperiksa terhadap skema permintaan yang dipublikasikan; tidak ada panggilan API terautentikasi atau bertagihan yang dilakukan untuk panduan ini.

Menghasilkan dan Menyimpan Gambar dengan API Nano Banana 2.1

Google: Generate dengan Python

Instal Google Gen AI Python SDK di lingkungan proyek tempat Anda akan menjalankan generate_image.py. Permintaan pertama di bawah meminta PNG 2K dengan komposisi 16:9 dan headline tertentu. Simpan hasil dan inspeksi sebelum menambahkan penyuntingan atau input gambar referensi.

python -m pip install -U google-genai

Simpan skrip berikut sebagai generate_image.py. Skrip ini mengikuti panduan generasi gambar Google untuk membuat interaksi, memeriksa gambar yang dikembalikan, mendekode datanya, dan menyimpan PNG. Prompt iklan produk menetapkan subjek, pencahayaan, dan headline persis sehingga Anda dapat memeriksa apakah keluaran memenuhi permintaan.

import base64
import os
from pathlib import Path
from google import genai

MODEL = "gemini-nano-banana-2.1"
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
image_format = {
    "type": "image",
    "mime_type": "image/png",
    "aspect_ratio": "16:9",
    "image_size": "2K",
}

def save_image(result, filename):
    image = result.output_image
    if image is None or not image.data:
        raise RuntimeError("No image returned; inspect the response before retrying")
    Path(filename).write_bytes(base64.b64decode(image.data))

interaction = client.interactions.create(
    model=MODEL,
    input=("Create a product advertisement for a white ceramic coffee mug. "
           "Use a warm studio background and soft side lighting. "
           "Include only the exact headline MORNING COFFEE."),
    response_format=image_format,
)
save_image(interaction, "mug-ad.png")
print("Saved mug-ad.png; interaction ID:", interaction.id)

python generate_image.py

Skrip menyimpan mug-ad.png dan mencetak ID interaksi. Gunakan pemeriksaan respons pada Langkah 3 sebelum menerima gambar atau melanjutkan dengan penyuntingan.

CometAPI: Generate dengan cURL

Dengan COMETAPI_KEY dikonfigurasi pada Langkah 1, jalankan permintaan Bash berikut menggunakan rute terdokumentasi CometAPI. Permintaan ini menyimpan respons JSON sebagai comet-response.json; Langkah 3 mengekstrak dan menyimpan gambar yang dikembalikan.

curl --fail-with-body --silent --show-error \
  "https://api.cometapi.com/v1beta/models/gemini-nano-banana-2.1:generateContent" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [{"parts": [{"text": "Create a studio product image of a white ceramic mug."}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}
  }' \
  --output comet-response.json

Menangani Respons

Google: Periksa Gambar yang Disimpan dan ID Interaksi

Helper save_image dalam Generatation memeriksa output_image, mendekode data gambar dan menyimpan mug-ad.png. Buka file tersebut dan verifikasi mug, komposisi, dan headline persis. Simpan ID interaksi untuk giliran penyuntingan berikutnya. Respons HTTP yang berhasil saja tidak menjamin bahwa gambar yang diminta dikembalikan.

Properti kemudahan output_image mengembalikan gambar terakhir yang dihasilkan. Jika Anda memerlukan banyak gambar atau teks dan visual berselang-seling, proses langkah-langkah interaksi. Periksa informasi gambar yang hilang atau keamanan sebelum mencoba kembali.

CometAPI: Ekstrak dan Simpan Gambar

Ini menulis respons JSON, bukan PNG. Konfirmasikan struktur respons aktual sebelum membangun ekstraktor gambar Anda. Jangan kirim previous_interaction_id atau response_format ke rute ini; opsi penyuntingan gateway dan ukuran output harus mengikuti skema terdokumentasinya sendiri. Demikian juga, ID interaksi Google bukan state percakapan gateway.

Jika gateway mengembalikan struktur native candidates → content → parts seperti yang dijelaskan dalam referensi generateContent Google, simpan bagian gambar inline dengan skrip mandiri ini. Skrip ini menerima nama field camelCase dan snake_case dan mempertahankan format gambar yang dikembalikan:

import base64
import json
from pathlib import Path

payload = json.loads(Path("comet-response.json").read_text(encoding="utf-8"))
saved = 0
for candidate in payload.get("candidates", []):
    for part in candidate.get("content", {}).get("parts", []):
        if part.get("thought"):
            continue
        blob = part.get("inlineData") or part.get("inline_data")
        if not blob or not blob.get("data"):
            continue
        mime = blob.get("mimeType") or blob.get("mime_type")
        ext = {"image/png": "png", "image/jpeg": "jpg", "image/webp": "webp"}.get(mime)
        if ext:
            saved += 1
            Path(f"comet-image-{saved}.{ext}").write_bytes(base64.b64decode(blob["data"]))
if not saved:
    raise RuntimeError("No inline image found; inspect response schema and error details")
print(f"Saved {saved} image(s)")

Simpan ekstraktor di atas sebagai save_comet_image.py di direktori yang sama dengan comet-response.json, lalu jalankan dengan Python. Buka tiap file comet-image yang disimpan dan periksa isinya. Jika tidak ada gambar inline yang ditemukan, periksa respons aktual dan detail error sebelum mengubah parser atau mencoba kembali.

Untuk kedua penyedia, verifikasi format gambar, dimensi, teks yang diminta, dan detail visualnya. Pertahankan penanganan respons spesifik penyedia secara terpisah dan simpan gambar asli sebelum melakukan penyuntingan.

Bagaimana Mengedit Gambar dengan API Nano Banana 2.1?

Menyunting Gambar yang Dihasilkan dengan Nano Banana 2.1

Tambahkan blok ini ke skrip yang sama. Ini menggunakan kembali klien, format output, dan interaksi dari contoh generasi. Seperti ditunjukkan dalam contoh penyuntingan multi-giliran Google, previous_interaction_id menyediakan konteks percakapan. Tentukan format output lagi untuk menjaga tipe file, rasio aspek, dan ukuran eksplisit.

edited = client.interactions.create(
    model=MODEL,
    previous_interaction_id=interaction.id,
    input=("Change only the mug color to matte black. "
           "Keep the headline, background, framing and lighting unchanged."),
    response_format=image_format,
)
save_image(edited, "mug-ad-edited.png")
print("Saved mug-ad-edited.png; interaction ID:", edited.id)

Untuk giliran ketiga, gunakan edited.id sebagai ID interaksi sebelumnya. Simpan ID terbaru pada sesi penyuntingan aplikasi Anda alih-alih dalam satu variabel global yang dibagikan semua pengguna. Simpan juga gambar asli: meminta latar tidak berubah tidak menjamin pelestarian piksel secara sempurna.

Mengirim Gambar Referensi Lokal ke Nano Banana 2.1

Jika Anda sudah memiliki gambar produk, kirimkan bersama instruksi edit alih-alih pertama-tama menghasilkan aset baru. Blok ini juga menggunakan klien dan helper save_image dari contoh generasi. MIME type yang dideklarasikan harus cocok dengan file aktual.

reference = base64.b64encode(Path("product.png").read_bytes()).decode("ascii")
from_reference = client.interactions.create(
    model=MODEL,
    input=[
        {"type": "text", "text": "Place this product on a clean studio backdrop. Preserve its shape and label."},
        {"type": "image", "mime_type": "image/png", "data": reference},
    ],
    response_format=image_format,
)
save_image(from_reference, "product-studio.png")

Mengontrol Keluaran Gambar dan Referensi Nano Banana 2.1

Gunakan kapasitas gambar referensi dan target konsistensi dalam tabel spesifikasi di atas sebagai baseline. Kapasitas tersebut tidak menjamin pelestarian identitas yang sempurna. Mulailah dengan jumlah referensi paling sedikit yang diperlukan, lalu evaluasi hasil secara menyeluruh. Untuk diagram dan aset pemasaran, berikan copy dan angka yang tepat dan terverifikasi alih-alih meminta model untuk mengarangnya.

Fitur Lanjutan

• Tingkat “thinking”: Setel ke “minimal” untuk kecepatan, “medium” (default) untuk keseimbangan, atau “high” untuk komposisi kompleks, tata letak sarat teks, atau kepatuhan multi-objek yang presisi. Thinking lebih tinggi meningkatkan latensi dan biaya token namun memperbaiki hasil pada prompt sulit.
• Grounding pencarian: Aktifkan tools Google Search / Image Search agar generasi dapat memasukkan referensi dunia nyata atau terkini (cuaca, produk, acara, spesies yang akurat, dll.).
• Input video: Didukung untuk generasi yang sadar konteks (mis. mengekstrak gaya atau subjek dari klip pendek).
• Batch API: Tersedia untuk pekerjaan offline volume tinggi dengan tarif lebih rendah.
• Resolusi & format: 1K default; minta 2K atau 4K secara eksplisit. Keluaran biasanya PNG/JPEG bergantung pada konfigurasi.

Selalu patuhi Kebijakan Penggunaan Terlarang Generative AI Google dan pastikan Anda memiliki hak atas gambar referensi apa pun.

Keluarga Nano Banana (Perkiraan, Data awal Oktober 2026)

Kesimpulan dan Rekomendasi

Nano Banana 2.1 adalah model generasi dan penyuntingan gambar ber-efisiensi tinggi terkuat Google hingga saat ini—peningkatan praktis yang secara nyata meningkatkan kualitas visual, fidelitas teks, konsistensi, dan ketahanan rasio aspek, sambil mempertahankan ekonomi tingkat Flash. Untuk sebagian besar beban kerja produksi yang membutuhkan gambar andal, berkualitas tinggi, dengan kepatuhan prompt yang baik dan kemampuan penyuntingan, ini adalah pilihan default yang jelas dalam keluarga Gemini pada Oktober 2026.

Mulai hari ini:

1. Prototipe di Google AI Studio.
2. Integrasikan melalui Gemini API resmi untuk kontrol maksimum.
3. Atau percepat pengembangan dan sederhanakan operasi multi-model dengan platform terpadu CometAPI yang kompatibel dengan OpenAI—satu key, harga kompetitif, akses cepat ke model terbaru termasuk gemini-nano-banana-2.1, dan analitik siap produksi.

Mulai bereksperimen melalui API, dan migrasikan beban kerja Nano Banana 2 yang tersisa sebelum batas waktu 29 Oktober. Alat untuk imagery AI yang berkualitas tinggi, konsisten, dan hemat biaya belum pernah semudah ini diakses.