Cara Menggunakan Nano Banana Pro/Nano Banana 2 API — Panduan Langkah demi Langkah untuk Pengembang

Jika Anda mencari “Nano Banana Pro API,” hal pertama yang membingungkan adalah namanya. Nama produknya adalah Nano Banana Pro. Nama API yang sebenarnya Anda gunakan dalam kode adalah gemini-3-pro-image. Setelah hal itu jelas, proses penyiapan selanjutnya tidak lagi membingungkan.

Gunakan Nano Banana Pro ketika gambar harus tetap utuh: teks yang mudah dibaca, detail produk, referensi merek, tata letak yang disesuaikan dengan pasar lokal, atau arahan visual dengan banyak batasan kecil. Jika Anda masih mencoba sepuluh versi dari ide yang sama, mulailah dengan Nano Banana 2 terlebih dahulu dan beralihlah ke Pro ketika arah desain tersebut layak untuk diinvestasikan lebih banyak.

Jika tim Anda masih sibuk menyusun prompt alih-alih merilis aplikasi, Ruang kerja Nano Banana Pro dari GlobalGPT merupakan sarana praktis untuk membandingkan hasil sebelum seorang pengembang mengintegrasikan API resmi. Ini merupakan jalan pintas alur kerja yang kreatif, bukan pengganti Konsol API Google, sistem penagihan, log, atau kontrol perusahaan.

Jawaban Singkat

Untuk menggunakan Nano Banana Pro melalui API, buat proyek Google AI Studio atau Google Cloud, buat kunci API Gemini, instal Google Gen AI SDK, dan panggil gemini-3-pro-image. Mulailah dengan satu permintaan konversi teks ke gambar biasa. Jika Anda masih memeriksa akses sebelum membangun API, maka Panduan Penggunaan Versi Uji Coba Gratis Gemini 3 Pro merupakan bacaan pelengkap yang bermanfaat.

Apa Sebenarnya API Nano Banana Pro Itu

Nano Banana Pro adalah model pembuat gambar bawaan premium milik Google dalam keluarga gambar Gemini. Dalam dokumen pengembang, Google menamainya Gemini 3 Pro Gambar. Itulah sebabnya string model tersebut terlihat berbeda dari nama pemasarannya.

API ini dapat menghasilkan gambar dari teks, menggunakan satu atau lebih gambar referensi, serta mengedit gambar yang sudah ada sesuai dengan instruksi tertulis. Hal ini menjadikannya berguna untuk mockup produk, varian iklan, diagram, materi kreatif yang disesuaikan dengan pasar lokal, dan alur kerja pengolahan gambar di mana teks di dalam gambar harus tetap dapat dibaca; untuk eksplorasi tanpa kode, Pembuat gambar GlobalGPT adalah tempat yang lebih mudah untuk menguji arah kreatifnya terlebih dahulu.

Nano Banana Pro vs Nano Banana 2

Pilihannya bukan soal nama mana yang terdengar lebih baru, melainkan lebih pada tahap mana Anda berada dalam proses pengerjaan. "Pro" diperuntukkan bagi proses penyuntingan yang cermat. "Nano Banana 2" diperuntukkan bagi siklus draf yang masih berantakan; jika jalur yang lebih cepat itulah yang Anda butuhkan, bacalah Nano Banana: Panduan Uji Coba Gratis 2 sebelum Anda merancang seluruh alur kerja yang berpusat pada Pro.

Konfigurasikan API dengan Titik Masuk yang Sebenarnya

Untuk prototipe, Google AI Studio biasanya merupakan cara tercepat. Untuk aplikasi perusahaan, gunakan konfigurasi Google Cloud yang sudah dipercaya oleh tim Anda, terutama jika Anda memerlukan penagihan bersama, kontrol akses, pencatatan, atau tata kelola Vertex AI. Jika keputusan akses benar-benar bergantung pada tingkatan paket Google, bandingkan kelebihan dan kekurangannya di Panduan Perbandingan Google AI Plus vs Pro sebelum menganggap pengaturan API sebagai satu-satunya masalah.

Dokumentasi publik adalah titik awal yang paling jelas. Dokumentasi ini memungkinkan Anda memastikan bahwa Anda berada di halaman pembuatan gambar Nano Banana, memeriksa apakah halaman tersebut menggunakan jalur API Interactions yang direkomendasikan, dan langsung beralih dari sana ke halaman kunci API atau AI Studio.

1. Buat atau buka proyek Google AI Studio atau Google Cloud.
2. Buat kunci API Gemini.
3. Simpan kunci tersebut sebagai variabel lingkungan di sisi server.
4. Pasang Google Gen AI SDK di proyek backend Anda.
5. Lakukan satu kali pengujian dengan resolusi rendah sebelum menambahkan gambar referensi atau fitur yang ditujukan untuk pengguna.

Halaman kunci API juga bersifat publik, tetapi pembuatan atau penayangan kunci tersebut bergantung pada akun Google dan izin proyek Anda. Poin utamanya: jangan sertakan kunci tersebut dalam kode JavaScript frontend. Browser atau aplikasi seluler harus memanggil backend Anda, dan backend Anda harus memanggil Gemini.

Setelah masuk, URL langsung AI Studio memang akan mengarahkan ke Playground dengan Nano Pisang Pro dipilih sebagai gemini-3-pro-image. Dalam ulasan ini, AI Studio juga menyoroti kendala praktis terkait akses: Nano Banana Pro memerlukan Google AI Plan atau kunci API agar Playground dapat menjalankannya.

The Dapatkan kode Tombol tersebut tetap perlu diperiksa pada tahap ini. Hal ini memastikan bahwa Anda berada dalam alur kerja pengembang, tetapi jika model terkunci untuk akun tersebut, panel kode mungkin terbuka tanpa potongan kode yang lengkap dan dapat dijalankan. Itu merupakan tanda pengaturan, bukan bug pada prompt.

export GEMINI_API_KEY="KUNCI_API_ANDA"

Buat Gambar Pertama

Permintaan pertama sebaiknya dibuat sesederhana mungkin. Anda sedang memeriksa otentikasi, akses model, format respons, dan penanganan berkas. Pekerjaan yang lebih rumit terkait prompt bisa ditunda sampai sistem sudah berjalan lancar.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "Buat mockup produk yang rapi dari cangkir perjalanan berbahan baja tahan karat "
 "di atas meja putih. Tambahkan label yang mudah dibaca: MORNING LAB."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

Prompt ini meminta mockup produk sederhana dengan teks yang mudah dibaca. Hal ini memberi Anda gambaran cepat mengenai tiga hal yang penting dalam pekerjaan nyata: realisme objek, komposisi, dan apakah model tersebut mampu menampilkan teks pendek dengan jelas. Untuk menyempurnakan prompt tanpa mengubah spesifikasi, coba gunakan brief yang sama di Ruang kerja Nano Banana Pro dari GlobalGPT pertama.

Mengedit Gambar dengan Referensi

Pengeditan berbasis referensi adalah fitur di mana Nano Banana Pro mulai menunjukkan keunggulannya. Alih-alih meminta gambar baru dari awal, Anda memberikan gambar kepada model dan memberitahukannya secara tepat bagian mana yang boleh diubah dan bagian mana yang harus tetap sama.

Jika Anda bukan seorang pengembang, bacalah bagian ini sebagai contoh alur kerja, bukan sebagai sesuatu yang harus Anda jalankan. Nama berkas product-reference.png artinya sekadar “gambar produk yang sudah ada.” Jika tugas utama Anda adalah membandingkan model gambar, maka dalam konteks yang lebih luas Uji coba alternatif Gemini 3 Pro dapat membantu Anda memutuskan apakah versi Pro layak untuk pengaturan tambahan tersebut.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "Pertahankan bentuk cangkir, pegangan, dan posisi logo tetap sama. "
            "Ubah latar belakang menjadi meja dapur yang cerah, tambahkan cahaya pagi yang hangat, "
 "dan pastikan semua teks tetap tajam dan mudah dibaca."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

Petunjuk pengeditan yang baik hampir mirip dengan umpan balik bagi seorang desainer: pertahankan ini, ubah itu, jangan pindahkan logo, pastikan teks tetap mudah dibaca. Instruksi yang tidak jelas seperti “buat agar terlihat premium” cenderung membuang-buang proses cetak karena memberikan terlalu banyak ruang bagi model untuk menebak-nebak.

Penetapan Harga dan Pengendalian Biaya

Gunakan halaman harga Google sebagai sumber informasi yang dapat diandalkan sebelum Anda mempublikasikan angka anggaran tetap. Berdasarkan verifikasi pada 21 Juli 2026, Google mencantumkan Nano Banana Pro di bawah Gemini 3 Pro Image dan memisahkan biaya teks/pemikiran dari biaya keluaran gambar.

Biaya keluaran gambar API, diverifikasi pada 21 Juli 2026

Pola biaya yang diterapkan cukup sederhana: buat draf dengan biaya lebih murah, lalu selesaikan dengan cermat. Biarkan Nano Banana 2 menangani variasi awal, kemudian kirimkan prompt dan referensi terbaik ke Nano Banana Pro untuk menghasilkan gambar akhir. Batasi juga resolusi sesuai tingkatan pengguna dan hindari pembuatan ulang saat prompt tidak berubah; jika Anda ingin jalur pembuatan draf khusus produk, Nano Banana 2 dalam GlobalGPT adalah pilihan yang lebih ringan untuk dicoba terlebih dahulu.

Catatan Produksi

Begitu pengguna dapat menghasilkan gambar dari produk Anda, Anda perlu menetapkan batasan. Biaya API gambar bisa melonjak dengan cepat, dan kegagalan harus dapat dijelaskan tanpa mengungkap detail penyedia secara mentah. Tim yang masih mempertimbangkan siapa saja yang memerlukan akses AI berbayar juga dapat membandingkan alur kerja berbasis langganan di ChatGPT Panduan Rencana Bisnis.

• Simpan kunci di sisi server: Jangan mengirimkan kunci API Gemini melalui browser atau aplikasi seluler.
• Catat informasi yang cukup untuk melakukan debug: ID model, hash prompt, ukuran keluaran, latensi, ID pengguna, dan status hasil.
• Tetapkan kuota: membatasi jumlah gambar per pengguna, ruang kerja, dan periode penagihan.
• Coba lagi dengan hati-hati: Coba ulang kegagalan sementara, tetapi jangan coba ulang kesalahan kebijakan atau kuota secara berulang-ulang.
• Tentukan aturan penyimpanan: Ketahui berapa lama Anda menyimpan gambar yang dihasilkan dan referensi yang diunggah.
• Tampilkan pesan kesalahan yang bermanfaat: beri tahu pengguna apakah masalahnya terkait akses, format file, kuota, atau kebijakan prompt.

Peran GlobalGPT

GlobalGPT paling cocok ditempatkan sebelum atau di samping proses pembuatan API. Seorang perancang dapat membandingkan Nano Banana Pro dengan Nano Pisang 2, GPT Image, Flux, dan model gambar lainnya dalam satu ruang kerja, lalu serahkan pola prompt yang paling efektif kepada pengembang.

Untuk kunci API resmi, penagihan, log, akses perusahaan, atau perutean Vertex AI, tetap gunakan platform pengembang Google. Untuk perbandingan ide yang lebih cepat dan mengurangi jumlah tab saat mengembangkan prompt, Ruang kerja generator gambar GlobalGPT dapat membuat karya-karya awalnya tidak terlalu kaku.

PERTANYAAN YANG SERING DIAJUKAN

Apakah Nano Banana Pro API sama dengan Gemini 3 Pro Image?

Untuk keperluan pengembangan, ya. Google mendokumentasikan Nano Banana Pro sebagai Gemini 3 Pro Image, dan ID model API-nya adalah gemini-3-pro-image.

Haruskah saya menggunakan Nano Banana Pro atau Nano Banana 2?

Gunakan Nano Banana Pro untuk hasil akhir yang membutuhkan kontrol lebih ketat, teks yang mudah dibaca, referensi, atau konsistensi merek. Gunakan Nano Banana 2 untuk pembuatan draf yang lebih cepat dan proses iterasi yang lebih hemat biaya.

Apakah saya bisa memanggil Nano Banana Pro langsung dari JavaScript frontend?

Tidak. Simpan kunci API di sisi server, alirkan permintaan melalui backend Anda, dan terapkan kuota pengguna sebelum mengirimkan permintaan ke API Gemini.

Apakah GlobalGPT menggantikan API resmi Google?

No. GlobalGPT berguna untuk pengujian cepat dan perbandingan kreatif lintas model, namun kunci API resmi, penagihan, log, dan kontrol tingkat perusahaan tersedia di platform pengembang Google.

Bagaimana cara memperkirakan biaya API Nano Banana Pro?

Gunakan halaman harga API Gemini Google yang terbaru dan buat perkiraan berdasarkan model, resolusi keluaran, serta volume gambar. Salah satu pola pengendalian biaya yang umum dilakukan adalah membuat draf terlebih dahulu menggunakan model yang lebih murah, kemudian menggunakan Nano Banana Pro untuk aset akhir yang telah dipilih.