Cara Mengakses API Nano Banana Pro

Google baru saja merilis Nano Banana Pro, nama kode resmi untuk Gemini 3 Pro Image, sebuah model multimodal canggih yang unggul dalam pembuatan teks-ke-gambar, pengeditan gambar, dan kontrol komposisi tingkat lanjut. Para pengembang kini dapat mengakses alat canggih ini secara terprogram melalui Gemini API. Detail konfigurasi kecil sering kali menentukan apakah integrasi Anda berhasil atau gagal dengan cepat.

💡

Sebelum melanjutkan, unduh Apidog secara gratis — ini menyederhanakan pengujian titik akhir API Nano Banana Pro, memvalidasi payload JSON, dan memalsukan respons tanpa menulis kode tambahan. Apidog menangani autentikasi Gemini API dengan mulus, sehingga Anda dapat berfokus pada penyusunan prompt daripada mengatasi kesalahan header.

tombol

Panduan ini akan memandu Anda melalui setiap langkah untuk mengakses dan menggunakan Nano Banana Pro API secara efektif.

Apa Itu Nano Banana Pro dan Mengapa Menggunakan API-nya?

Google DeepMind membangun Nano Banana Pro di atas fondasi Gemini 3 Pro. Ini menghasilkan output gambar berkualitas studio yang tidak dapat dicocokkan oleh model sebelumnya. Pertama, ia merender teks di dalam gambar dengan akurasi yang luar biasa — bayangkan logo yang terbaca, rambu multi-bahasa, atau kaligrafi bergaya yang selaras sempurna dengan adegan. Selanjutnya, ia mendukung hingga 14 gambar masukan untuk pencampuran sambil mempertahankan konsistensi di antara hingga lima subjek. Selain itu, pengembang mengontrol sudut kamera, pencahayaan, kedalaman bidang, pewarnaan warna, dan bahkan resolusi hingga 4K.

Prompt: Buat infografis tentang tanaman ini dengan fokus pada informasi menarik

Selain itu, model ini mendasarkan generasi pada data Google Search secara real-time saat Anda mengaktifkan fitur tersebut. Ini memastikan akurasi faktual untuk diagram, infografis, atau mockup produk. Setiap output membawa tanda air SynthID untuk pelacakan asal.

Anda mengakses Nano Banana Pro melalui Gemini API standar, tetapi Anda memilih pengidentifikasi model spesifik (gemini-3-pro-image-preview atau penerus stabilnya). Pendekatan ini menjaga kode Anda kompatibel dengan varian Gemini lainnya sambil membuka kemampuan gambar tingkat pro.

Langkah demi Langkah: Dapatkan Kunci API Gemini Anda

Ikuti langkah-langkah berikut untuk mendapatkan kredensial:

Buka Google AI Studio dan masuk dengan akun Google Anda.

Klik tombol "Dapatkan kunci API" di bilah sisi kiri.

Buat kunci baru atau gunakan yang sudah ada.

Sebagai alternatif, di Vertex AI:

Buka dasbor Vertex AI Studio.
Pilih "AI Generatif" → "Model Garden."
Temukan Nano Banana Pro (terdaftar sebagai Gemini 3 Pro Image).
Klik "Aktifkan API" dan hasilkan kredensial.

Simpan kunci dengan aman di variabel lingkungan. Jangan pernah menuliskannya secara langsung di file sumber.

Panggil Nano Banana Pro API dari Google AI Studio (Mulai Cepat)

Anda sering memulai di Google AI Studio untuk eksperimen cepat. Pertama, kunjungi ai.studio/banana-pro. Pilih "Nano Banana Pro" dari daftar drop-down model.

Kemudian, beralih ke tab "API" untuk melihat contoh curl yang secara otomatis diisi dengan kunci Anda.

Berikut adalah permintaan curl dasar:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{
        "text": "Generate a 4K photorealistic image of a yellow banana floating in space with Earth in the background, add text overlay: \"Nano Banana Pro\""
      }]
    }],
    "generationConfig": {
      "responseModal": "IMAGE"
    }
  }'

Titik akhir ini tetap sama dengan model Gemini lainnya — hanya nama model yang berubah.

Gunakan SDK Python Resmi untuk Nano Banana Pro

Sebagian besar pengembang lebih memilih pustaka klien Python karena ia menangani percobaan ulang, streaming, dan tipe mime secara otomatis. Instal terlebih dahulu:

pip install -U google-generativeai

Konfigurasi pustaka dan hasilkan gambar:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel('models/gemini-3-pro-image-preview')

response = model.generate_content(
    "A futuristic cityscape at golden hour with flying cars and the text 'Welcome to 2042' on a billboard, 4K resolution",
    generation_config=genai.types.GenerationConfig(
        response_mime_type="image/png"
    )
)

response.candidates[0].content.parts[0].inline_data.data  # base64 image

Simpan outputnya seperti ini:

with open("output.png", "wb") as f:
    f.write(response.candidates[0].content.parts[0].inline_data.data)

SDK mengabstraksi detail tingkat rendah, sehingga Anda berfokus pada rekayasa prompt.

Tangani Pengeditan Gambar dan Masukan Multi-Gambar

Nano Banana Pro unggul dalam tugas pengeditan. Unggah gambar sebagai bagian dari prompt. Contohnya:

import PIL.Image

img = PIL.Image.open("reference.jpg")

response = model.generate_content(
    [img, "Edit this photo: change daytime to dramatic sunset, add bokeh effect, keep the subject unchanged"]
)

Anda dapat menggabungkan beberapa gambar dan teks dengan mulus. Model ini menjaga konsistensi subjek di seluruh referensi.

Fitur Canggih: Grounding, Pengaturan Keamanan, dan Kontrol

Aktifkan grounding Google Search untuk menyuntikkan fakta real-time:

"systemInstruction": {
  "parts": [{"text": "Use search grounding for factual elements"}]
}

Sesuaikan pengaturan keamanan untuk memblokir atau mengizinkan kategori:

model = genai.GenerativeModel( 'models/gemini-3-pro-image-preview', safety_settings=[ {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"} ] )

Tentukan rasio aspek dan kualitas:

generation_config=genai.types.GenerationConfig(
    candidate_count=1,
    temperature=0.7,
    extra_params={
        "aspect_ratio": "16:9",
        "quality": "highest"
    }
)

Uji dan Debug Panggilan API Nano Banana Pro dengan Apidog

Perintah curl manual berfungsi untuk pengujian sekali pakai, tetapi Apidog mengubah alur kerja Anda. Impor spesifikasi OpenAPI Gemini resmi ke Apidog, dan itu secara otomatis menghasilkan semua titik akhir, termasuk varian Nano Banana Pro.

Berikut adalah manfaat yang bisa Anda dapatkan:

Visualisasikan skema JSON untuk permintaan generateContent.
Simpan lingkungan (kunci dev/staging/prod).
Rantai permintaan dan assert respons.
Buat mock API secara lokal untuk pengembangan offline.
Hasilkan kode klien dalam 20+ bahasa secara instan.

Misalnya, buat permintaan baru di Apidog, tempelkan titik akhir Gemini, tambahkan kunci API Anda sebagai header, dan kirim payload multi-bagian yang kompleks dengan gambar yang diunggah dalam hitungan detik. Apidog memvalidasi bidang yang diperlukan bahkan sebelum Anda menekan "Kirim," mencegah kesalahan 400 yang umum.

Banyak tim melaporkan siklus iterasi 50-70% lebih cepat setelah beralih ke Apidog untuk pengujian Gemini API.

Deploy Nano Banana Pro di Vertex AI untuk Produksi

Pengguna enterprise meningkatkan skala dengan Vertex AI. Buat titik akhir kustom:

Buka Vertex AI → Model Garden.
Deploy "Gemini 3 Pro Image (Nano Banana Pro)."
Konfigurasi tipe mesin dan penskalaan otomatis.
Panggil titik akhir prediksi dengan Vertex SDK.

Jalur ini menyediakan titik akhir pribadi, logging, dan integrasi pemantauan dengan Cloud Operations.

Harga, Batas Kecepatan, dan Praktik Terbaik

Nano Banana Pro biayanya lebih mahal daripada model yang lebih ringan karena persyaratan komputasinya yang lebih tinggi. Periksa tarif terbaru di halaman harga Gemini API karena tarif tersebut dapat berubah selama pratinjau.

Terapkan backoff eksponensial untuk percobaan ulang. Cache prompt umum jika memungkinkan. Selain itu, gabungkan permintaan yang tidak terkait hanya jika kasus penggunaan Anda memungkinkan — generasi gambar belum mendukung batching sejati.

Selalu sertakan prompt yang jelas dan terstruktur. Rujuk panduan prompt resmi untuk Nano Banana Pro untuk memaksimalkan kualitas.

Memecahkan Masalah Umum

Anda akan mengalami kesalahan "model not found" jika Anda menggunakan pengidentifikasi yang salah. Pastikan Anda menargetkan gemini-3-pro-image-preview selama fase pratinjau berbayar.

Untuk kegagalan autentikasi, hasilkan kembali kunci Anda dan verifikasi tidak ada spasi di akhir. Jika gambar tampak diberi tanda air secara tidak terduga, ingatlah bahwa hanya tingkat tertentu yang menghilangkan kilauan yang terlihat.

Ketika output tampak disensor, sesuaikan ambang batas keamanan secara eksplisit.

Kesimpulan

Anda kini memiliki semua pengetahuan untuk mengakses dan mengintegrasikan Nano Banana Pro API secara efektif. Mulailah dengan Google AI Studio untuk hasil instan, pindah ke SDK Python untuk scripting, dan manfaatkan Apidog untuk menyederhanakan pengujian dan debugging.

Kombinasi kemampuan Gemini 3 Pro Image di bawah bendera Nano Banana Pro membuka kemungkinan baru untuk desain otomatis, aset pemasaran yang dipersonalisasi, dan alat visualisasi data. Terapkan langkah-langkah ini, bereksperimen dengan berani, dan saksikan aplikasi Anda menghasilkan visual yang menyaingi studio profesional.

Unduh Apidog hari ini dan percepat pengembangan Nano Banana Pro Anda — perbedaan dalam produktivitas akan terlihat jelas setelah sesi pertama Anda.

tombol