Panduan Lengkap Dokumentasi Pengembangan Nano Banana 2: Perbandingan 2 Solusi Antara API Resmi dan Integrasi APIYI

Catatan Penulis: Panduan lengkap dokumentasi pengembangan Nano Banana 2 (gemini-3.1-flash-image-preview), membandingkan dua solusi integrasi antara API resmi Google dan platform APIYI, lengkap dengan contoh kode, konfigurasi parameter, dan strategi hemat biaya.

Bagi pengembang yang ingin mengintegrasikan Nano Banana 2, saat ini ada dua dokumen pengembangan yang bisa dijadikan referensi: dokumentasi resmi Google (ai.google.dev/gemini-api/docs/image-generation) dan dokumentasi platform APIYI (docs.apiyi.com/api-capabilities/nano-banana-2-image).

Kedua solusi ini memiliki keunggulannya masing-masing—dokumentasi resmi memiliki fitur paling lengkap, sementara dokumentasi APIYI menawarkan integrasi termudah dengan harga mulai dari $0.03/gambar. Artikel ini akan membandingkan konten inti dari kedua dokumen tersebut untuk membantu Anda memilih cara integrasi yang paling sesuai.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai parameter API lengkap Nano Banana 2, contoh kode untuk kedua solusi integrasi, serta pilihan optimal untuk berbagai skenario penggunaan.

Referensi Cepat Parameter Inti Dokumentasi Nano Banana 2

Mari kita lihat konfigurasi parameter yang paling penting. Parameter ini berlaku untuk kedua cara integrasi:

14 Rasio Aspek yang Didukung Nano Banana 2

🎯 Tips Pengembangan: 1:4, 4:1, 1:8, dan 8:1 adalah rasio aspek baru yang eksklusif untuk Nano Banana 2 dan tidak didukung oleh Nano Banana Pro. Jika aplikasi Anda membutuhkan Banner panjang atau infografis, Anda harus menggunakan gemini-3.1-flash-image-preview.

Solusi Integrasi Nano Banana 2 A: API Resmi Google

Pemanggilan Dasar API Resmi

API resmi Google menggunakan Google Gen AI SDK, yang mendukung Python, JavaScript, Go, Java, dan REST.

from google import genai
from google.genai import types

client = genai.Client()

# Teks ke gambar dasar
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Seekor kucing oranye berguling-guling di dedaunan musim gugur, warna hangat",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

# Ekstrak gambar yang dihasilkan
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)

from google import genai
from google.genai import types

client = genai.Client()

# Konfigurasi parameter lengkap: resolusi 2K + layar lebar 16:9 + mode berpikir High
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Sampul laporan tahunan perusahaan teknologi, judul 'AI Vision 2026', nuansa biru tua, gaya minimalis",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
        thinking_config=types.ThinkingConfig(
            thinking_level="High",
            include_thoughts=True
        )
    )
)

# Parsing respons (termasuk proses Berpikir)
for part in response.parts:
    if part.thought and part.text:
        print(f"[Proses Berpikir] {part.text}")
    elif part.inline_data:
        with open("report_cover.png", "wb") as f:
            f.write(part.inline_data.data)
        print("Gambar telah disimpan")

Pembuatan Gambar dengan Koneksi Internet Image Search dari API Resmi

Ini adalah kemampuan eksklusif Nano Banana 2—melakukan pencarian gambar Google untuk mendapatkan referensi visual nyata sebelum membuat gambar:

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Tesla Model Y terbaru tahun 2026, warna perak, parkir di jalanan kota",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        tools=[
            types.Tool(google_search=types.GoogleSearch(
                search_types=types.SearchTypes(
                    web_search=types.WebSearch(),
                    image_search=types.ImageSearch()
                )
            ))
        ]
    )
)

🎯 Catatan: Pembuatan gambar dengan Image Search memiliki persyaratan tampilan—Anda harus menyediakan tautan yang dapat diklik ke halaman web sumber gambar. Token Thinking akan tetap ditagih baik proses penalaran dikembalikan atau tidak.

Solusi Integrasi Nano Banana 2 B: Platform APIYI

Keunggulan Integrasi Platform APIYI

Pemanggilan Format Kompatibel OpenAI APIYI

Jika Anda sudah memiliki kode berbasis OpenAI SDK, Anda hanya perlu mengubah dua baris untuk terhubung ke Nano Banana 2:

import openai

client = openai.OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{"role": "user", "content": "Lukisan lanskap tinta Tiongkok, komposisi ruang kosong, pegunungan jauh diselimuti awan dan kabut"}]
)

import requests
import base64

API_KEY = "YOUR_APIYI_KEY"

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "contents": [{"parts": [{"text": "Poster promosi e-commerce, judul besar 'Promo Musim Semi', tema merah"}]}],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {
                "aspectRatio": "9:16",
                "imageSize": "2K"
            }
        }
    },
    timeout=300
).json()

# Dekode dan simpan gambar
img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("poster.png", "wb") as f:
    f.write(base64.b64decode(img_data))
print("Gambar berhasil dibuat, biaya sekitar $0.03")

Saran: Daftar melalui APIYI apiyi.com untuk mendapatkan Kunci API dan mulai melakukan pemanggilan. Platform ini mendukung format kompatibel OpenAI dan format asli Google, satu kunci bisa digunakan untuk semua model.

Perbandingan Harga Dua Skema Nano Banana 2

Perbandingan Biaya Bulanan Nano Banana 2 (1.000 gambar per hari)

Harga $0.03/panggilan dari APIYI tidak hanya 55% lebih murah dari harga standar resmi, tetapi bahkan lebih rendah dari harga Batch resmi yang sudah didiskon setengah ($0.034) — dan hasilnya dikembalikan secara real-time, tanpa perlu menunggu proses asinkron selama 24 jam.

🎯 Skema Hemat: Gunakan APIYI apiyi.com untuk pemanggilan model Nano Banana 2, hanya butuh $30 untuk 1.000 gambar per hari, dengan biaya bulanan $900. Daftar sekarang dan dapatkan kuota uji coba gratis; satu Key mendukung Nano Banana 2, Pro, dan model populer lainnya secara bersamaan.

Panduan Pengembangan Fitur Lanjutan Nano Banana 2

Pengeditan Gambar dalam Percakapan Multi-turn

Nano Banana 2 mendukung modifikasi berkelanjutan pada gambar yang sama dalam sebuah percakapan:

# Pengeditan multi-turn format APIYI + OpenAI
messages = [
    {"role": "user", "content": "Buat logo brand gaya minimalis, nuansa biru"},
    # Lanjutkan pengeditan setelah hasil putaran pertama kembali
    {"role": "assistant", "content": "[Hasil pembuatan putaran pertama]"},
    {"role": "user", "content": "Ubah warnanya menjadi ungu gradasi, tambahkan nama perusahaan 'TechFlow'"}
]

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=messages
)

Pembuatan Gambar Referensi Nano Banana 2

Pilihan Mode Thinking Nano Banana 2

🎯 Tips Pengembangan: Token Thinking akan tetap dikenakan biaya terlepas dari apakah includeThoughts=true diatur atau tidak. Jika Anda tidak perlu melihat proses penalaran, biarkan saja di pengaturan default false — ini tidak akan memengaruhi kualitas pembuatan, hanya saja teks penalaran perantara tidak akan dikembalikan.

Referensi Kecepatan Pembuatan Nano Banana 2

Saran: Saat melakukan pemanggilan Nano Banana 2, disarankan mengatur timeout=300 (300 detik) untuk menghindari kegagalan akibat fluktuasi jaringan atau daya komputasi Google. Melalui pemanggilan APIYI (apiyi.com), Anda bisa mendapatkan koneksi yang lebih stabil.

Pertanyaan Umum (FAQ)

Ringkasan

Poin-poin utama dari dokumentasi pengembangan Nano Banana 2:

1. Dua solusi dengan keunggulannya masing-masing: API resmi Google memiliki fitur terlengkap (Image Search, Thinking, 14 gambar referensi), sementara APIYI menawarkan harga terendah ($0,03/pemanggilan) dan integrasi termudah.
2. APIYI $0,03 = 45% harga resmi: Respons waktu nyata (real-time), bahkan lebih murah daripada harga Batch resmi ($0,034) tanpa perlu menunggu 24 jam.
3. Parameter inti bersifat universal: 4 tingkat resolusi, 14 jenis rasio aspek, mode Thinking, dan parameter lainnya dapat digunakan di kedua solusi tersebut.

Bagi sebagian besar pengembang, kami merekomendasikan akses cepat ke Nano Banana 2 melalui APIYI apiyi.com — dengan harga $0,03/pemanggilan, format yang kompatibel dengan OpenAI, kuota gratis saat pendaftaran, Anda bisa menghasilkan gambar pertama dalam waktu kurang dari 5 menit.

📚 Referensi

1. Dokumentasi Pembuatan Gambar Gemini Resmi: Referensi API lengkap Nano Banana 2

   • Tautan: ai.google.dev/gemini-api/docs/image-generation
   • Deskripsi: Dokumentasi resmi untuk semua parameter, fungsi, dan fitur tingkat lanjut.

2. Dokumentasi Nano Banana 2 APIYI: Panduan akses cepat dan contoh kode

   • Tautan: docs.apiyi.com/api-capabilities/nano-banana-2-image
   • Deskripsi: Panduan integrasi platform APIYI, termasuk harga dan contoh pemanggilan model.

3. Harga Resmi Gemini API: Harga presisi untuk setiap resolusi

   • Tautan: ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview
   • Deskripsi: Harga standar dan harga Batch untuk 0.5K/1K/2K/4K.

4. Batas Kecepatan Gemini API: Batasan pemanggilan model Preview

   • Tautan: ai.google.dev/gemini-api/docs/rate-limits
   • Deskripsi: Pahami batasan kuota untuk model Preview.

Penulis: Tim Teknis APIYI
Diskusi Teknis: Jangan ragu untuk membagikan pengalaman pengembangan Nano Banana 2 Anda di kolom komentar. Untuk informasi lebih lanjut mengenai model AI lainnya, kunjungi pusat dokumentasi APIYI di docs.apiyi.com.