Mengatasi batas ukuran input Nano Banana 2: Rumus perhitungan Token dan 6 metode perbaikan kesalahan 65536

Saat menggunakan Nano Banana 2 untuk pembuatan gambar, Anda mungkin pernah menemui error ini: The input token count exceeds the maximum number of tokens allowed (65536). Ini adalah salah satu kebingungan paling umum yang dialami developer saat memanggil API pembuatan gambar Gemini — kartu model resmi jelas-jelas menuliskan batas token input 131.072, lalu mengapa batas sebenarnya adalah 65.536?

Nilai Inti: Setelah membaca artikel ini, Anda akan sepenuhnya memahami batasan Token input dan output Nano Banana 2, rumus perhitungan Token gambar yang akurat, serta 6 metode praktis untuk mengatasi error 65536.

Spesifikasi Model Nano Banana 2: Tabel Parameter Lengkap

ID model dasar Nano Banana 2 adalah gemini-3.1-flash-image-preview. Berikut adalah spesifikasi lengkap yang diambil dari kartu model resmi:

Matriks Dukungan Fitur Nano Banana 2

🎯 Peringatan Penting: Nano Banana 2 tidak mendukung Caching (cache konteks), yang berarti setiap permintaan perlu mengirim ulang seluruh konten input. Untuk skenario yang melibatkan banyak gambar referensi, ini akan secara signifikan meningkatkan konsumsi Token. Saat melakukan pemanggilan model melalui platform APIYI apiyi.com, disarankan untuk mengoptimalkan konten input guna mengontrol penggunaan Token di setiap permintaan.

Masalah Utama Batasan Token Nano Banana 2: 65536 atau 131072?

Ini adalah pertanyaan yang paling membingungkan bagi developer: Dokumentasi resmi menyebutkan 131.072, tetapi API mengembalikan error yang menyatakan batas atasnya adalah 65.536.

Faktanya: Perbedaan Kebijakan Platform, Bukan Perbedaan Kemampuan Model

Mengapa ada perbedaan?

Sebagai model pembuatan gambar, Nano Banana 2 perlu mengalokasikan banyak sumber daya komputasi untuk proses sintesis gambar (diffusion head). Berbeda dengan model teks murni yang dapat menggunakan seluruh kapasitas jendela konteks untuk memahami input, model pembuatan gambar perlu mempertahankan pipeline generatif secara bersamaan.

• Firebase AI Logic menggunakan batasan 65.536 yang lebih konservatif, kemungkinan mempertimbangkan stabilitas untuk perangkat seluler dan edge.
• Vertex AI / Google AI menyediakan batasan 131.072 penuh, ditujukan untuk pengembangan sisi server dan cloud.

Dampak Sebenarnya: Jika kamu memanggil melalui Gemini API standar dan menerima error 65.536, kemungkinan penyebabnya adalah:

1. Versi SDK yang kamu gunakan secara default melewati jalur Firebase.
2. Batasan platform pada tahap pratinjau belum diseragamkan.
3. Batasan kuota untuk wilayah atau tingkatan tertentu.

💡 Saran Berdasarkan Pengujian: Saat memanggil Nano Banana 2 melalui platform APIYI apiyi.com, disarankan untuk menjaga input token di bawah 65.536. Dengan begitu, batasan tidak akan terpicu, tidak peduli platform mana yang digunakan di bawahnya. Platform APIYI akan secara otomatis memilih jalur pemanggilan yang optimal.

Formula Perhitungan Token Gambar Input Nano Banana 2

Memahami bagaimana gambar diubah menjadi token adalah kunci untuk mengatasi masalah ukuran input. Gemini menggunakan strategi pembagian blok (Tiling) untuk menghitung konsumsi token gambar.

Aturan Perhitungan Dasar

Aturan Satu: Gambar Kecil (Kedua sisi ≤ 384px)

Token 消耗 = 258 tokens (nilai tetap)

Gambar apa pun yang kedua sisinya tidak melebihi 384 piksel, terlepas dari ukuran sebenarnya, akan selalu mengonsumsi 258 token. Ini adalah pilihan yang paling ekonomis.

Aturan Dua: Gambar Besar (Salah satu sisi > 384px)

Token 消耗 = ceil(width ÷ 768) × ceil(height ÷ 768) × 258

Gambar besar akan dibagi menjadi blok (Tile) berukuran 768×768, dan setiap blok mengonsumsi 258 token.

Tabel Cepat Konsumsi Token untuk Ukuran Gambar Umum

Kontrol Parameter media_resolution

Model seri Gemini 3 mendukung parameter media_resolution yang dapat mengontrol konsumsi token setiap gambar input secara presisi:

Penemuan Penting: Pengaturan HIGH default mengonsumsi 1.120 token per gambar. Jika kamu mengirimkan 14 gambar referensi (batas Nano Banana 2) dalam satu permintaan, gambar saja sudah mengonsumsi 15.680 token — ditambah petunjuk teks, sangat mudah mendekati batasan 65.536.

Detail Konsumsi Token Output Nano Banana 2

Output juga memiliki batasan Token: 32.768 Token. Setiap gambar yang dihasilkan akan mengonsumsi jumlah Token output yang berbeda tergantung pada resolusinya:

Jumlah Output Maksimum per Permintaan

Berdasarkan batas atas Token output 32.768:

🚀 Saran Pembuatan Massal: Jika kamu perlu membuat banyak gambar, disarankan untuk menggunakan Batch API (diskon harga 50%) daripada memasukkan banyak gambar dalam satu permintaan. Melalui platform APIYI apiyi.com, pemanggilan Batch API didukung, dan setiap gambar 1K hanya membutuhkan sekitar $0.015.

Detail Format dan Batasan Input Nano Banana 2

Format Gambar Input yang Didukung

Batasan Ukuran File

Batasan Resolusi Gambar Input

• Resolusi input maksimum: 3072×3072 piksel
• Gambar yang melebihi resolusi ini akan secara otomatis diskalakan secara proporsional hingga 3072×3072
• Rasio aspek akan tetap terjaga setelah penskalaan

Dukungan Input PDF

Nano Banana 2 mendukung PDF sebagai input, tetapi perlu diperhatikan konsumsi Token:

• Setiap halaman PDF diperlakukan sebagai gambar, dan mengonsumsi Token yang sama dengan gambar
• Pada resolusi HIGH (default), setiap halaman mengonsumsi sekitar 1.120 Token
• Dengan batas atas 65.536 Token, maksimal sekitar 58 halaman PDF dapat didukung
• Saran: Hanya masukkan halaman yang diperlukan, jangan masukkan seluruh dokumen

Rasio Aspek yang Didukung Nano Banana 2

Nano Banana 2 menambahkan beberapa rasio aspek ekstrem baru dibandingkan dengan Nano Banana Pro:

💡 Penjelasan Rasio Baru: Rasio ekstrem 4:1, 1:4, 8:1, 1:8 yang baru ditambahkan di Nano Banana 2 cocok untuk skenario khusus seperti membuat banner situs web, infografis memanjang, dan gambar samping. Semua rasio dapat langsung digunakan melalui platform APIYI apiyi.com.

6 Cara Mengatasi Error Batas Token 65536 pada Nano Banana 2

6 Cara Mengatasi Kesalahan 65536 Token Diurutkan berdasarkan efek dan rekomendasi · Kombinasi penggunaan memberikan hasil terbaik

Metode Penghematan token Kesulitan Rekomendasi Satu kalimat penjelasan

① Turunkan media_resolution TINGGI→SEDANG atau RENDAH 50%-75% ↓ Sederhana ★★★★★ Perubahan satu baris parameter

② Pangkas ukuran gambar masukan Praproses hingga ≤384px 75%+ ↓ Sederhana ★★★★★ Tetapkan 258 token

③ Kurangi jumlah gambar referensi 14 lembar→3-5 lembar Linearitas ↓ Sederhana ★★★★ Hanya unggah gambar yang diperlukan

④ Pisahkan permintaan Pemrosesan batch multi-gambar/PDF panjang Melewati batasan Sedang ★★★★ Perlu modifikasi kode

⑤ Menggunakan Files API Ganti base64 sebaris ~33% turun Sedang ★★★ Mengurangi pembengkakan badan permintaan

⑥ Sederhanakan petunjuk teks 500 kata→100 kata ~600 Sederhana ★★★ Ekspresi yang disempurnakan lebih efektif

Rekomendasi kombinasi: ① + ② + ③ digunakan secara bersamaan · Sumber data: Tim teknis APIYI apiyi.com

Ketika Anda menemui error The input token count exceeds the maximum number of tokens allowed (65536), berikut adalah 6 cara yang dapat membantu Anda mengatasinya:

Metode Satu: Turunkan Parameter media_resolution (Direkomendasikan)

Efek: Konsumsi Token berkurang 50%-75%

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI unified interface
)

# Kurangi konsumsi Token dengan menurunkan resolusi gambar input
# HIGH (default) = 1.120 token/gambar
# MEDIUM = 560 token/gambar (berkurang 50%)
# LOW = 280 token/gambar (berkurang 75%)

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel("gemini-3.1-flash-image-preview")

# Tentukan resolusi saat mengunggah gambar
image = genai.upload_file("input.jpg")

response = model.generate_content(
    contents=[
        "Edit this image to add a sunset background",
        image
    ],
    generation_config={
        "response_modalities": ["IMAGE", "TEXT"],
        "media_resolution": "MEDIUM"  # Turunkan dari HIGH ke MEDIUM
    }
)

# MEDIUM: 560 token/gambar (dibandingkan HIGH: 1.120 token/gambar)
# 14 gambar: 7.840 token (dibandingkan 15.680 token)

Metode Dua: Perkecil Ukuran Gambar Input

Efek: Kompresi maksimal hingga 258 token/gambar

Sebelum mengirim ke API, perkecil gambar referensi hingga di bawah 384×384:

from PIL import Image

def optimize_for_token(img_path, max_size=384):
    """Mengecilkan gambar hingga di bawah 384px, konsumsi Token tetap 258"""
    img = Image.open(img_path)
    img.thumbnail((max_size, max_size), Image.LANCZOS)
    optimized_path = img_path.replace(".", "_optimized.")
    img.save(optimized_path, quality=85)
    return optimized_path

# Sebelum optimasi: 1024x1024 = 1.032 token
# Setelah optimasi: 384x384 = 258 token (hemat 75%)

Metode Tiga: Kurangi Jumlah Gambar Referensi

Efek: Pengurangan konsumsi Token secara linear

Nano Banana 2 mendukung hingga 14 gambar input, tetapi sebagian besar skenario tidak memerlukan sebanyak itu:

Saran: Hanya masukkan gambar referensi yang benar-benar diperlukan. Untuk skenario konsistensi wajah, biasanya 2-3 gambar sudah cukup, tidak perlu 14 gambar.

Metode Empat: Pisahkan Permintaan

Efek: Melewati batasan permintaan tunggal

Jika Anda perlu memproses banyak gambar atau PDF panjang, pisahkan permintaan menjadi beberapa permintaan kecil:

def split_process(images, prompt, batch_size=3):
    """Memisahkan permintaan multi-gambar menjadi batch kecil"""
    results = []
    for i in range(0, len(images), batch_size):
        batch = images[i:i+batch_size]
        response = client.images.generate(
            model="nano-banana-2",
            prompt=prompt,
            # Hanya masukkan gambar sejumlah batch_size setiap kali
        )
        results.append(response)
    return results

Metode Lima: Gunakan Files API sebagai Pengganti Base64 Inline

Efek: Menghindari ukuran payload permintaan yang terlalu besar, dapat mengunggah file lebih besar

Encoding base64 inline dapat membuat ukuran payload permintaan membengkak sekitar 33%. Menggunakan Files API memungkinkan Anda mengunggah file terlebih dahulu untuk mendapatkan referensi, lalu menggunakannya dalam permintaan:

# Unggah gambar besar menggunakan Files API (mendukung 20-100MB)
file = genai.upload_file("large_image.png")

# Referensikan dalam permintaan, bukan inline
response = model.generate_content([
    "Based on this reference, generate a similar style image",
    file  # Referensi bukan base64
])

Metode Enam: Sederhanakan Petunjuk Teks

Efek: Membebaskan lebih banyak Token untuk gambar

Jangan abaikan bahwa petunjuk teks juga mengonsumsi Token. Petunjuk yang terlalu panjang akan menghabiskan anggaran Token yang berharga:

• ❌ Deskripsi detail 500 kata → ~750 token
• ✅ Petunjuk ringkas 100 kata → ~150 token
• Hemat: ~600 token, setara dengan menambahkan satu gambar resolusi MEDIUM

🎯 Saran Komprehensif: Dalam pengembangan nyata, kami merekomendasikan kombinasi penggunaan Metode Satu + Metode Dua + Metode Tiga. Saat memanggil Nano Banana 2 melalui platform APIYI apiyi.com, atur media_resolution ke MEDIUM, pra-proses gambar input hingga 384px, dan hanya masukkan gambar referensi yang diperlukan. Dengan begitu, konsumsi Token dapat dikendalikan di bawah 5.000, jauh dari batasan 65.536.

Perbandingan Batasan Token Nano Banana 2 dengan Model Lain

Perbedaan Utama:

1. Batasan Token input Nano Banana 2 jauh lebih kecil daripada Gemini 3 Flash (teks saja) (65K vs 1M). Ini adalah batasan arsitektur pembuatan gambar.
2. Batasan input Nano Banana Pro (~200K) lebih tinggi daripada Nano Banana 2, cocok untuk pengeditan kompleks yang membutuhkan banyak jendela konteks.
3. Gemini 2.5 Flash Image menggunakan model sederhana dengan Token tetap per gambar, tanpa perhitungan Token yang rumit.

Pertanyaan Umum

Ringkasan

Batasan Token Nano Banana 2 bukanlah masalah, melainkan mekanisme yang perlu dipahami. Dengan menguasai poin-poin berikut, Anda bisa mengelolanya dengan mudah:

1. Batas input 65.536-131.072 — Merencanakan dengan 65.536 adalah yang paling aman
2. Perhitungan Token gambar — Gambar kecil 258 tetap, gambar besar dibagi per blok 768×768
3. media_resolution adalah cara penyesuaian yang paling efektif — HIGH→MEDIUM langsung mengurangi 50%
4. Batas output 32.768 — Maksimal 43 gambar 512px atau 13 gambar 4K per panggilan
5. 6 metode solusi — Penggunaan kombinasi memberikan hasil terbaik

Disarankan untuk memanggil Nano Banana 2 melalui platform APIYI apiyi.com, untuk menikmati kemampuan model secara penuh dengan harga $0.03/gambar. Platform ini menyediakan statistik penggunaan Token yang detail, membantu Anda mengoptimalkan setiap pemanggilan dengan tepat.

📝 Penulis: Tim APIYI | Tim Teknis APIYI
🔗 Diskusi Teknis: Kunjungi apiyi.com untuk panduan integrasi lengkap Nano Banana 2
📅 Tanggal Pembaruan: 27 Februari 2026