Panduan Lengkap Output Rasio Asli Nano Banana Pro API: 3 Skenario untuk Menghasilkan Gambar Ukuran Asli

Catatan Penulis: Penjelasan mendalam tentang cara mencapai output rasio asli dengan API Nano Banana Pro, menguasai teknik menghilangkan parameter aspect_ratio, dan menyelesaikan masalah mempertahankan dimensi dalam skenario pengeditan gambar.

Saat menggunakan API Nano Banana Pro untuk mengedit gambar, cara mempertahankan ukuran gambar asli adalah masalah yang sering dihadapi pengembang. Dokumentasi resmi secara eksplisit membatasi aspect_ratio hanya pada 10 rasio tetap, namun sebenarnya ada solusi sederhana: cukup hapus parameter aspect_ratio dalam skenario pengeditan gambar untuk mendapatkan output ukuran asli.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai teknik lengkap output rasio asli di API Nano Banana Pro, sehingga Anda bisa mengontrol ukuran gambar secara fleksibel di berbagai skenario.

Poin Utama Output Rasio Asli Nano Banana Pro

Prinsip Utama Output Rasio Asli Nano Banana Pro

Nano Banana Pro (dikenal juga sebagai Gemini 3 Pro Image) memiliki dua perilaku default yang berbeda saat memproses gambar. Untuk skenario pembuatan gambar murni dari teks (text-to-image), jika Anda tidak menentukan aspect_ratio, API akan secara default menghasilkan gambar persegi 1:1.

Namun, dalam skenario pengeditan gambar (image-to-image), perilaku API sangat berbeda. Saat Anda menyediakan gambar referensi dan meminta pengeditan, jika Anda tidak menyertakan parameter aspect_ratio, API akan secara otomatis mengenali dimensi asli dari gambar input dan menghasilkan output dengan ukuran yang sama persis. Inilah mekanisme inti untuk mencapai output rasio asli.

Mengapa Output Rasio Asli Nano Banana Pro Berfungsi

Desain ini sangat logis: ketika pengguna mengunggah gambar untuk diedit, mereka biasanya mengharapkan gambar hasil memiliki ukuran dan rasio yang sama dengan gambar aslinya. Memaksa pengguna untuk menghitung dan menentukan rasio secara manual tidak hanya menambah kompleksitas pengembangan, tetapi juga berisiko menyebabkan distorsi atau pemotongan gambar yang tidak diinginkan jika rasio yang ditentukan tidak cocok.

Penjelasan Detail Aturan Resmi Output Rasio Asli Nano Banana Pro

Dokumentasi API resmi secara jelas menetapkan bahwa parameter aspect_ratio hanya menerima 10 nilai preset berikut:

Tips Penting: Batasan rasio di atas hanya berlaku untuk skenario yang memerlukan penentuan dimensi tertentu. Dalam skenario pengeditan gambar, disarankan untuk melakukan pengujian melalui platform APIYI (apiyi.com). Cukup kosongkan parameter aspect_ratio untuk mendapatkan output sesuai ukuran aslinya.

Panduan Cepat Output Rasio Asli Nano Banana Pro

Contoh Super Simpel: Edit Gambar Tetap dengan Rasio Asli

Berikut adalah cara termudah untuk mengimplementasikan output rasio asli:

import openai
import base64

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

# Membaca gambar asli dan melakukan encoding
with open("input.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode()

# Kunci: Jangan mengirim parameter aspect_ratio
response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{image_base64}"}},
            {"type": "text", "text": "将图片背景改为日落场景"}
        ]
    }]
)

import openai
import base64
from pathlib import Path

def edit_image_keep_ratio(
    image_path: str,
    edit_prompt: str,
    output_path: str = "output.png"
) -> bool:
    """
    Mengedit gambar dan mempertahankan dimensi asli

    Args:
        image_path: Jalur gambar input
        edit_prompt: Instruksi pengeditan
        output_path: Jalur gambar output

    Returns:
        Apakah berhasil
    """
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://vip.apiyi.com/v1"
    )

    # Membaca dan melakukan encoding gambar
    image_data = Path(image_path).read_bytes()
    image_base64 = base64.b64encode(image_data).decode()

    # Mendeteksi format gambar
    suffix = Path(image_path).suffix.lower()
    mime_type = {"jpg": "jpeg", "jpeg": "jpeg", "png": "png", "webp": "webp"}.get(suffix[1:], "jpeg")

    try:
        # Inti: Jangan kirim aspect_ratio, secara otomatis mempertahankan dimensi asli
        response = client.chat.completions.create(
            model="gemini-3-pro-image-preview",
            messages=[{
                "role": "user",
                "content": [
                    {"type": "image_url", "image_url": {"url": f"data:image/{mime_type};base64,{image_base64}"}},
                    {"type": "text", "text": edit_prompt}
                ]
            }]
        )

        # Simpan hasil
        result_base64 = response.choices[0].message.content
        output_data = base64.b64decode(result_base64)
        Path(output_path).write_bytes(output_data)
        return True

    except Exception as e:
        print(f"Gagal mengedit: {e}")
        return False

# Contoh penggunaan
edit_image_keep_ratio(
    "product.jpg",
    "移除图片背景，保留主体产品",
    "product_nobg.png"
)

Saran: Dapatkan kuota uji coba gratis melalui APIYI (apiyi.com) untuk memverifikasi efek output rasio asli dengan cepat. Platform ini mendukung pemanggilan fungsi lengkap dari model Nano Banana Pro.

Perbandingan Tiga Skenario Output Rasio Asli Nano Banana Pro

Skenario 1: Teks-ke-Gambar Memerlukan Rasio Tertentu

Saat melakukan pembuatan gambar murni dari teks, jika Anda memerlukan ukuran tertentu, parameter aspect_ratio harus ditentukan secara eksplisit:

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{"role": "user", "content": "seekor kucing yang lucu"}],
    extra_body={
        "image_config": {
            "aspect_ratio": "16:9",  # Wajib ditentukan
            "resolution": "2K"
        }
    }
)

Skenario 2: Edit Gambar Menjaga Ukuran Asli

Ini adalah skenario inti dari artikel ini, Anda cukup mengabaikan parameter aspect_ratio:

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{img}"}},
            {"type": "text", "text": "tingkatkan warna gambar"}
        ]
    }]
    # Tanpa extra_body atau aspect_ratio
)

Skenario 3: Edit Gambar dengan Mengubah Rasio secara Paksa

Jika Anda memang perlu mengubah ukuran saat melakukan pengeditan, Anda bisa mengirimkan parameternya secara eksplisit:

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{img}"}},
            {"type": "text", "text": "ubah komposisi gambar menjadi persegi"}
        ]
    }],
    extra_body={"image_config": {"aspect_ratio": "1:1"}}
)

Catatan Perbandingan: Konfigurasi parameter di atas telah diverifikasi di platform APIYI (apiyi.com) dan terbukti efektif.

Pertanyaan yang Sering Diajukan (FAQ)

Ringkasan

Poin-poin penting untuk output rasio asli di Nano Banana Pro:

1. Kosongkan untuk Ukuran Asli: Dalam skenario pengeditan gambar, tidak menyertakan parameter aspect_ratio akan mempertahankan dimensi gambar asli.
2. Pahami Perbedaan Skenario: Mode text-to-image secara default menggunakan rasio 1:1, sedangkan mode pengeditan gambar secara default menggunakan ukuran asli. Perilaku kedua mode ini berbeda.
3. 10 Pilihan Rasio Prasetel: Saat perlu menentukan ukuran tertentu, Anda hanya dapat memilih dari 10 rasio yang didukung secara resmi.

Setelah menguasai teknik ini, Anda dapat dengan mudah menghasilkan output ukuran asli dalam skenario seperti pengeditan foto produk, retouching potret, atau penggantian latar belakang, sehingga menghindari repotnya menyesuaikan ukuran secara manual nantinya.

Direkomendasikan untuk mencoba hasilnya dengan cepat melalui APIYI apiyi.com. Platform ini menyediakan kuota gratis dan dukungan penuh untuk model Nano Banana Pro.

📚 Referensi

⚠️ Penjelasan Format Tautan: Semua tautan eksternal menggunakan format Nama Sumber: domain.com agar mudah disalin namun tidak dapat diklik secara langsung, guna menghindari hilangnya bobot SEO.

1. Dokumentasi Resmi Google Gemini API: Penjelasan lengkap parameter pembuatan gambar Nano Banana

   • Tautan: ai.google.dev/gemini-api/docs/nanobanana
   • Keterangan: Dokumentasi resmi yang otoritatif, mencakup definisi lengkap parameter aspect_ratio.

2. fal.ai Nano Banana Pro API: Penjelasan detail antarmuka (interface) dari platform pihak ketiga

   • Tautan: fal.ai/models/fal-ai/nano-banana-pro/edit/api
   • Keterangan: Berisi contoh konfigurasi parameter untuk skenario image-to-image.

3. Forum Pengembang Google AI: Diskusi komunitas dan tanya jawab

   • Tautan: discuss.ai.google.dev
   • Keterangan: Tempat untuk menemukan berbagi pengalaman dari pengembang lain mengenai kontrol ukuran gambar.

Penulis: Tim Teknis
Diskusi Teknis: Selamat berdiskusi tentang tips penggunaan Nano Banana Pro API di kolom komentar. Untuk informasi lebih lanjut, kunjungi komunitas teknis APIYI apiyi.com.