Tutorial Lengkap Panggilan API Nano Banana Pro: 44% Lebih Murah dari KIE.ai, Integrasi Cepat Format Asli Google

Catatan Penulis: Penjelasan mendalam tentang cara memanggil API Nano Banana Pro, menggunakan format Gemini asli Google, melalui platform APIYI hanya dengan biaya $0,05/panggilan, 44% lebih murah dibandingkan KIE.ai, serta mendukung pembuatan gambar resolusi 1K/2K/4K.

Saat memanggil API Nano Banana Pro, banyak pengembang mungkin langsung terpikir untuk menggunakan KIE.ai, namun sebenarnya ada pilihan yang lebih murah dan lebih stabil. Artikel ini akan membahas cara menggunakan format API Gemini asli Google untuk memanggil Nano Banana Pro, dan melalui platform APIYI, Anda bisa menekan biaya per panggilan hingga $0,05 — 44% lebih rendah daripada KIE.ai.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai cara standar pemanggilan API Nano Banana Pro, memahami perbedaan harga antar platform, dan mampu menghasilkan gambar kelas profesional 4K dengan biaya terendah.

Intip Parameter Inti API Nano Banana Pro

Mengapa Nano Banana Pro Menggunakan Format Asli Google?

Nano Banana Pro (nama model gemini-3-pro-image-preview) adalah model pembuatan gambar tingkat profesional yang diluncurkan oleh Google DeepMind. Desain API-nya berbasis protokol asli Gemini, yang memiliki perbedaan mendasar dengan format OpenAI:

• Parameter Modalitas Respons: Perlu mendeklarasikan responseModalities: ["IMAGE"] di dalam generationConfig, bukan menggunakan response_format seperti pada OpenAI.
• Kontrol Resolusi: Menentukan 1K/2K/4K melalui kolom resolution, bukan dengan ukuran piksel manual.
• Rasio Aspek: Menggunakan string aspectRatio (seperti "16:9"), bukan nilai numerik lebar dan tinggi.

Jika Anda mencoba memanggilnya dengan format OpenAI SDK, Anda akan menemui kesalahan penguraian parameter. Cara yang benar adalah menggunakan Google Generative AI SDK atau langsung mengirim permintaan HTTP ke endpoint yang kompatibel.

Apa Saja yang Bisa Dihasilkan Nano Banana Pro?

Model ini sangat menonjol dalam skenario berikut, jauh melampaui kompetitor sejenis:

• Rendering Teks Multibahasa: Mendukung penyematan teks yang akurat dalam bahasa Mandarin, Inggris, Jepang, dan lainnya ke dalam gambar dengan font yang jelas tanpa karakter berantakan.
• Infografis & Visualisasi Data: Dapat menghasilkan infografis profesional yang berisi bagan, tabel, dan anotasi data.
• Materi Pemasaran: Poster, foto produk, banner iklan dengan tata letak teks yang presisi.
• Tampilan Produk: Pencahayaan fisik yang akurat, detail material, dan efek bayangan yang realistis.
• Ilustrasi Presentasi: Ilustrasi slide yang sesuai dengan estetika profesional.

Perbandingan Harga API Nano Banana Pro di Berbagai Platform

Sebelum memilih platform, mari kita lihat perbedaan biaya riil di antara berbagai platform:

💰 Perbandingan Biaya: Berdasarkan perhitungan pembuatan 100 gambar 4K per hari, biaya bulanan Google resmi sekitar $720, KIE.ai sekitar $360, sedangkan melalui APIYI apiyi.com hanya butuh $150, menghemat biaya operasional bulanan lebih dari $570.

Keunggulan Utama APIYI dibandingkan KIE.ai:

1. Harga Lebih Murah: $0.05/kali vs $0.09/kali di KIE.ai, hemat 44%
2. Kompatibilitas Format: Mendukung langsung format Gemini API native Google, tidak perlu konversi format
3. Kecepatan Lebih Tinggi: Jalur akselerasi yang dioptimalkan, hasil pengujian menunjukkan respons yang lebih stabil
4. Interface Terpadu: Mendukung model populer lainnya seperti GPT, Claude, dan Gemini secara bersamaan, memudahkan peralihan antar model

Panduan Cepat API Nano Banana Pro

Metode 1: Menggunakan Google Generative AI SDK (Direkomendasikan)

Instalasi SDK:

pip install google-generativeai

Contoh pemanggilan paling sederhana (Text-to-Image, 10 baris kode):

import google.generativeai as genai
import base64

genai.configure(
    api_key="YOUR_API_KEY",
    # Menggunakan endpoint APIYI, harga hanya $0.05/kali
    client_options={"api_endpoint": "vip.apiyi.com"}
)

model = genai.GenerativeModel("gemini-3-pro-image-preview")
response = model.generate_content(
    "Seekor kucing oranye duduk di ladang bunga matahari, sinar matahari cerah, gaya realistis, HD 4K",
    generation_config=genai.GenerationConfig(
        response_modalities=["IMAGE"],
        resolution="4K",
        aspect_ratio="16:9"
    )
)

# Simpan gambar
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(base64.b64decode(part.inline_data.data))
        print("Gambar telah disimpan: output.png")

🚀 Mulai Cepat: Setelah mendaftar di APIYI apiyi.com, Anda bisa mendapatkan API Key dan kuota uji coba gratis. Cukup salin kode di atas dan ganti YOUR_API_KEY untuk menjalankannya, tanpa perlu konfigurasi tambahan lainnya.

import google.generativeai as genai
import base64
import os
from pathlib import Path
from typing import Optional, List


def setup_client(api_key: str):
    """Inisialisasi klien API Nano Banana Pro"""
    genai.configure(
        api_key=api_key,
        # Dipanggil melalui APIYI, harga $0.05/kali, 79% lebih murah dari resmi
        client_options={"api_endpoint": "vip.apiyi.com"}
    )
    return genai.GenerativeModel("gemini-3-pro-image-preview")


def text_to_image(
    model,
    prompt: str,
    resolution: str = "2K",       # 1K / 2K / 4K
    aspect_ratio: str = "1:1",    # 1:1 / 16:9 / 9:16 / 4:3 / 3:4
    output_path: str = "output.png"
) -> str:
    """
    Text-to-Image: Menghasilkan gambar berdasarkan deskripsi teks

    Args:
        model: Instance model yang sudah diinisialisasi
        prompt: Deskripsi gambar (mendukung bahasa Indonesia/Inggris)
        resolution: Resolusi output 1K/2K/4K
        aspect_ratio: Rasio aspek
        output_path: Jalur penyimpanan

    Returns:
        Jalur file yang disimpan
    """
    response = model.generate_content(
        prompt,
        generation_config=genai.GenerationConfig(
            response_modalities=["IMAGE"],
            resolution=resolution,
            aspect_ratio=aspect_ratio
        )
    )

    for part in response.candidates[0].content.parts:
        if part.inline_data and part.inline_data.mime_type.startswith("image/"):
            with open(output_path, "wb") as f:
                f.write(base64.b64decode(part.inline_data.data))
            return output_path

    raise ValueError("API tidak mengembalikan data gambar, silakan periksa apakah petunjuk memicu filter konten")


def image_to_image(
    model,
    prompt: str,
    reference_image_path: str,
    resolution: str = "2K",
    output_path: str = "edited_output.png"
) -> str:
    """
    Image-to-Image: Mengedit atau mengubah gaya berdasarkan gambar referensi

    Args:
        model: Instance model yang sudah diinisialisasi
        prompt: Instruksi pengeditan (misal: "ubah latar belakang menjadi malam hari")
        reference_image_path: Jalur gambar referensi
        resolution: Resolusi output
        output_path: Jalur penyimpanan

    Returns:
        Jalur file yang disimpan
    """
    # Baca gambar referensi
    with open(reference_image_path, "rb") as f:
        image_data = base64.b64encode(f.read()).decode()

    # Deteksi format gambar
    ext = Path(reference_image_path).suffix.lower()
    mime_map = {".jpg": "image/jpeg", ".jpeg": "image/jpeg",
                ".png": "image/png", ".webp": "image/webp"}
    mime_type = mime_map.get(ext, "image/png")

    response = model.generate_content(
        [
            {"inline_data": {"mime_type": mime_type, "data": image_data}},
            prompt
        ],
        generation_config=genai.GenerationConfig(
            response_modalities=["IMAGE"],
            resolution=resolution
        )
    )

    for part in response.candidates[0].content.parts:
        if part.inline_data and part.inline_data.mime_type.startswith("image/"):
            with open(output_path, "wb") as f:
                f.write(base64.b64decode(part.inline_data.data))
            return output_path

    raise ValueError("Pemrosesan Image-to-Image gagal, pastikan format gambar referensi benar")


def batch_generate(
    model,
    prompts: List[str],
    resolution: str = "2K",
    output_dir: str = "batch_output"
) -> List[str]:
    """
    Pembuatan gambar secara batch

    Args:
        model: Instance model
        prompts: Daftar petunjuk
        resolution: Resolusi
        output_dir: Direktori output

    Returns:
        Daftar jalur file yang dihasilkan
    """
    os.makedirs(output_dir, exist_ok=True)
    results = []

    for i, prompt in enumerate(prompts):
        output_path = f"{output_dir}/image_{i+1:03d}.png"
        try:
            path = text_to_image(model, prompt, resolution, output_path=output_path)
            results.append(path)
            print(f"[{i+1}/{len(prompts)}] Berhasil dibuat: {path}")
        except Exception as e:
            print(f"[{i+1}/{len(prompts)}] Gagal dibuat: {e}")
            results.append(None)

    return results


# Contoh Penggunaan
if __name__ == "__main__":
    # Inisialisasi klien - Dipanggil melalui APIYI apiyi.com, $0.05/kali
    model = setup_client("YOUR_APIYI_API_KEY")

    # Contoh Text-to-Image
    path = text_to_image(
        model,
        prompt="Gambar tampilan produk gaya minimalis modern, latar belakang putih, pencahayaan studio profesional, cocok untuk e-commerce",
        resolution="4K",
        aspect_ratio="1:1",
        output_path="product_4k.png"
    )
    print(f"Gambar produk 4K telah dibuat: {path}")

    # Contoh Image-to-Image (mengubah gambar yang sudah ada)
    edited = image_to_image(
        model,
        prompt="Ubah latar belakang dalam gambar menjadi pemandangan alam luar ruangan, jaga subjek tetap sama",
        reference_image_path="product_4k.png",
        resolution="4K",
        output_path="product_outdoor.png"
    )
    print(f"Gambar setelah diedit: {edited}")

Metode 2: Menggunakan Permintaan HTTP Langsung (Cocok untuk bahasa apa pun)

Jika Anda tidak ingin menginstal SDK, Anda juga dapat mengirim permintaan HTTP POST secara langsung:

import requests
import base64
import json

API_KEY = "YOUR_APIYI_API_KEY"
# Endpoint APIYI yang kompatibel dengan format native Google
BASE_URL = "https://vip.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

payload = {
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Ruang server pusat data yang penuh dengan nuansa teknologi, efek lampu neon biru, ultra-clear 4K, tekstur sinematik"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "resolution": "4K",
        "aspectRatio": "16:9"
    }
}

response = requests.post(BASE_URL, headers=headers, json=payload)
data = response.json()

# Ekstrak dan simpan gambar
image_data = data["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("datacenter_4k.png", "wb") as f:
    f.write(base64.b64decode(image_data))
print("Pembuatan gambar selesai!")

Catatan: Kode di atas menggunakan endpoint kompatibel dari APIYI apiyi.com, sepenuhnya kompatibel dengan format Gemini API native Google, tanpa perlu konversi format apa pun, hanya $0.05/kali.

Detail Parameter Inti Nano Banana Pro

Tabel Parameter Lengkap Resolusi dan Rasio Aspek

Rasio Aspek yang Didukung (nilai parameter aspectRatio):

Lanskap: "16:9"  "4:3"  "3:2"  "21:9"
Persegi: "1:1"
Potret: "9:16"  "3:4"  "2:3"  "9:21"
Kustom: "4:5" (Rekomendasi Instagram)

Praktik Terbaik Petunjuk (Prompt)

Nano Banana Pro sangat sensitif terhadap kualitas petunjuk, berikut adalah pola penulisan yang telah terbukti efektif:

Struktur Petunjuk Berkualitas Tinggi: Deskripsi Subjek + Definisi Gaya + Efek Cahaya/Tekstur + Kata Kunci Resolusi/Kualitas

✅ Cara penulisan yang direkomendasikan:
"Seorang wanita muda mengenakan Hanfu tradisional berdiri di taman klasik,
 gaya lukisan Gongbi, cahaya alami yang lembut, detail kaya, 4K ultra-clear,
 sangat realistis"

❌ Cara penulisan yang harus dihindari:
"Gambar seorang perempuan" (terlalu ambigu)

Petunjuk Khusus Perenderan Teks (Keunggulan utama Nano Banana Pro):

"Sebuah poster acara, teks judul '2026 AI Summit',
 bilingual Mandarin-Inggris, gaya desain modern, latar belakang biru tua,
 font judul putih, tulisan jelas dan terbaca"

Skenario Penggunaan Praktis API Nano Banana Pro

Skenario 1: Pembuatan Batch Gambar Produk E-commerce

# Pembuatan batch gambar tampilan produk e-commerce
product_prompts = [
    "Earphone Bluetooth nirkabel, latar belakang putih bersih, fotografi produk profesional, tampilan depan, 4K",
    "Earphone Bluetooth nirkabel, latar belakang abu-abu tua, sudut 45 derajat, menunjukkan detail earphone, 4K",
    "Earphone Bluetooth nirkabel, skenario gaya hidup, gambar efek pemakaian, sinar matahari luar ruangan, 4K"
]

results = batch_generate(
    model,
    product_prompts,
    resolution="4K",
    output_dir="product_images"
)
# 3 gambar, total biaya APIYI: $0.15 (KIE.ai butuh $0.27)

Skenario 2: Desain Teks Poster Pemasaran

Salah satu kemampuan paling menonjol dari Nano Banana Pro adalah perenderan teks yang presisi di dalam gambar, sesuatu yang sulit dilakukan oleh model serupa:

poster_prompt = """
Desain sebuah poster promosi Double 11:
- Judul: Promo Besar Double 11
- Subjudul: Diskon mulai 50%
- Latar belakang: Gradasi merah, gaya perayaan meriah
- Warna teks: Kuning emas, font besar mencolok
- Bawah: Waktu acara 2026.11.11-11.13
Persyaratan: Teks Mandarin jelas terbaca, tata letak profesional
"""

path = text_to_image(model, poster_prompt, resolution="4K", aspect_ratio="9:16")
# Poster ponsel vertikal, $0.05/lembar

💡 Saran Skenario: Untuk skenario yang membutuhkan pembuatan gambar dalam jumlah besar (seperti gambar produk e-commerce, materi pemasaran), disarankan untuk memanggil melalui platform APIYI (apiyi.com). Selain harganya paling rendah, platform ini juga menyediakan log panggilan mendetail dan statistik penggunaan untuk memudahkan kontrol biaya.

Skenario 3: Integrasi Proyek Node.js / TypeScript

Jika proyek Anda menggunakan JavaScript/TypeScript, Anda dapat mengintegrasikannya langsung melalui permintaan HTTP:

import axios from "axios";
import * as fs from "fs";

const API_KEY = "YOUR_APIYI_API_KEY";
// APIYI kompatibel dengan format asli Google, harga $0.05/kali
const BASE_URL = "https://vip.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent";

interface GenerateImageOptions {
  prompt: string;
  resolution?: "1K" | "2K" | "4K";
  aspectRatio?: string;
  outputPath?: string;
}

async function generateImage({
  prompt,
  resolution = "2K",
  aspectRatio = "1:1",
  outputPath = "output.png",
}: GenerateImageOptions): Promise<string> {
  const response = await axios.post(
    BASE_URL,
    {
      contents: [{ role: "user", parts: [{ text: prompt }] }],
      generationConfig: {
        responseModalities: ["IMAGE"],
        resolution,
        aspectRatio,
      },
    },
    {
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${API_KEY}`,
      },
    }
  );

  const imageData =
    response.data.candidates[0].content.parts[0].inlineData.data;
  fs.writeFileSync(outputPath, Buffer.from(imageData, "base64"));
  return outputPath;
}

// Contoh penggunaan
generateImage({
  prompt: "Halaman splash App gaya minimalis modern, tema gelap, nuansa teknologi kuat, 4K",
  resolution: "4K",
  aspectRatio: "9:16",
  outputPath: "app_splash.png",
}).then((path) => console.log(`Pembuatan selesai: ${path}`));

Strategi Optimasi Biaya

Dalam proyek nyata, mengontrol biaya panggilan API Nano Banana Pro secara wajar sangatlah penting:

🎯 Saran Pemilihan: Untuk tim startup dan pengembang individu, direkomendasikan untuk mencoba terlebih dahulu di platform APIYI (apiyi.com) menggunakan kuota gratis untuk memverifikasi apakah kualitas gambar sesuai kebutuhan sebelum melakukan panggilan skala besar. Platform ini menyediakan sistem pembayaran sesuai penggunaan (pay-as-you-go) tanpa batasan konsumsi minimum.

{每月 3000 次调用：不同方案成本对比} {按 4K 分辨率 · 3000 次/月 计算}

{$0} {$150} {$300} {$450} {$600} {$720}

{$720} {Google} {Resmi}

{$360} {KIE.ai} {Pihak Ketiga}

{$150} {APIYI} {Direkomendasikan ✓}

{~$75} {APIYI} {+缓存优化}

{Hemat $360}

{Hemat $570}

{Hemat $645}

{基于每月 3000 次 4K 图像生成估算 · 实际成本以平台账单为准 · APIYI apiyi.com}

Pertanyaan Umum (FAQ)

Kesimpulan

Poin inti pemanggilan API Nano Banana Pro:

1. Gunakan Format Asli Gemini: Wajib menggunakan SDK google-generativeai atau permintaan HTTP native, karena format SDK OpenAI tidak kompatibel.
2. Harga Terbaik di APIYI: $0.05 per pemanggilan, 44% lebih rendah dari KIE.ai ($0.09), dan 79% lebih rendah dari harga resmi Google ($0.24).
3. 3 Parameter Kunci: responseModalities: ["IMAGE"], resolution (1K/2K/4K), dan aspectRatio.
4. Render Teks adalah Keunggulan Utama: Untuk poster pemasaran, infografis, dan konten bilingual, Nano Banana Pro adalah pilihan terbaik saat ini.

Bagi tim yang membutuhkan pemanggilan massal atau penerapan di lingkungan produksi, direkomendasikan untuk mengaksesnya melalui APIYI apiyi.com — platform ini telah berjalan stabil, menyediakan log API yang detail, serta pemantauan penggunaan untuk membantu mengontrol biaya pembuatan gambar secara presisi.

Referensi

1. Dokumentasi Pembuatan Gambar Google Gemini API

   • Tautan: ai.google.dev/gemini-api/docs/image-generation
   • Deskripsi: Deskripsi parameter API resmi dan batasan penggunaan Nano Banana Pro

2. Google Generative AI Python SDK

   • Tautan: github.com/google-gemini/generative-ai-python
   • Deskripsi: Instalasi SDK dan referensi API lengkap, kode dalam artikel ini didasarkan pada SDK ini

3. Dokumentasi Integrasi Nano Banana Pro di Platform APIYI

   • Tautan: docs.apiyi.com
   • Deskripsi: Penjelasan kompatibilitas APIYI terhadap format asli Google dan detail harga

Penulis: Tim Teknis
Diskusi Teknis: Jangan ragu untuk membagikan karya yang Anda buat dengan Nano Banana Pro di kolom komentar. Untuk tips pembuatan gambar AI lainnya, kunjungi komunitas teknis APIYI di apiyi.com