|

Proses Lengkap Integrasi API Nano Banana 2: Penjelasan Langkah Pembelian Resmi dan Rekomendasi Layanan Proksi API

Catatan Penulis: Panduan lengkap langkah demi langkah untuk akses resmi API Nano Banana 2 (penautan kartu di AI Studio + konfigurasi Vertex AI), analisis batasan jaringan bagi pengguna di luar AS, serta bagaimana APIYI hadir sebagai solusi cadangan untuk memenuhi kebutuhan bisnis Anda.

Artikel sebelumnya membahas akses ke Nano Banana Pro, kali ini kita akan membahas "saudaranya", Nano Banana 2 (gemini-3.1-flash-image-preview). Meskipun keduanya berbasis model gambar Gemini, alur akses NB2 memiliki perbedaan—sistem penagihan AI Studio baru saja diperbarui pada Maret 2026 (sistem prabayar), dan konfigurasi Vertex AI juga memiliki perbedaan. Artikel ini akan memandu Anda langkah demi langkah melalui proses pembelian resmi, lalu memberikan APIYI sebagai solusi cadangan—untuk memastikan Anda tetap bisa "terhubung langsung ke layanan resmi" sekaligus menjamin kelangsungan bisnis saat layanan resmi mengalami gangguan atau limit kuota.

Nilai Inti: Menyelesaikan seluruh alur pembelian resmi, memahami biaya dan hambatan di setiap langkah, serta menyiapkan APIYI sebagai solusi cadangan untuk menjamin kontinuitas bisnis.

nano-banana-2-api-access-guide-billing-flow-apiyi-alternative-id 图示

Informasi Inti Akses Resmi Nano Banana 2 API

Dimensi Penjelasan
ID Model gemini-3.1-flash-image-preview
Nama Lain Nano Banana 2
Pintu Masuk Resmi AI Studio (pengembang) / Vertex AI (tingkat perusahaan)
Kuota Gratis Hampir nol (blog resmi menyatakan "memerlukan kunci API berbayar")
Isi Saldo Minimum Prabayar AI Studio minimal $10
Resolusi 512px / 1K / 2K / 4K
Harga per 4K $0,151/gambar (standar) · $0,076/gambar (diskon 50% Batch)
Tersedia di Indonesia Tidak dapat diakses langsung

Alur 1: Pembelian dan Akses via AI Studio (Langkah Lengkap)

AI Studio adalah pintu masuk pilihan bagi sebagian besar pengembang. Pada Maret 2026, sistem penagihan baru saja diubah—dari penagihan terkait GCP menjadi sistem prabayar/pascabayar bawaan AI Studio.

Langkah 1: Buat Akun Google dan Masuk ke AI Studio

Operasi Catatan
Kunjungi aistudio.google.com Memerlukan akun Google non-Tiongkok
Masuk dengan akun Google Akun yang terdaftar di wilayah Tiongkok mungkin dibatasi
Pilih "Mulai" saat pertama kali masuk Setujui ketentuan layanan

Catatan untuk pengguna di Tiongkok: Anda memerlukan VPN untuk mengakses AI Studio. Selain itu, meskipun menggunakan VPN, Google akan mendeteksi wilayah pendaftaran akun—disarankan menggunakan akun Gmail wilayah AS.

Langkah 2: Buat kunci API

Operasi Penjelasan
Klik "API Keys" di menu kiri AI Studio
Klik "Create API Key"
Pilih proyek GCP (atau buat baru) Proyek default akan dibuat secara otomatis
Salin kunci yang dihasilkan Simpan dengan baik, hanya ditampilkan sekali

Saat ini, Anda mendapatkan kunci tingkat gratis—Nano Banana 2 hampir tidak dapat digunakan pada tingkat gratis (RPD sangat rendah atau bahkan nol), sehingga harus ditingkatkan ke tingkat berbayar.

Langkah 3: Tautkan Metode Pembayaran dan Isi Saldo

Mulai 23 Maret 2026, AI Studio menggunakan sistem penagihan baru:

Mode Penagihan Penjelasan Cocok untuk
Prabayar (Prepay) Isi saldo dulu baru gunakan, minimal $10 Pengembang individu, anggaran terkontrol
Pascabayar (Postpay) Gunakan dulu baru bayar (perlu verifikasi kredit) Pengguna perusahaan

Langkah pengisian saldo prabayar:

  1. Masuk ke halaman AI Studio → Billing
  2. Klik "Buy Credits"
  3. Pilih jumlah isi saldo ($10 / $50 / $100 / kustom, maksimal $5.000)
  4. Masukkan informasi kartu kredit

Kartu kredit yang didukung: Visa, Mastercard, American Express, Discover, JCB

Hambatan bagi pengguna di Tiongkok: Memerlukan kartu kredit luar negeri. Kartu UnionPay domestik tidak diterima. Anda memerlukan kartu kredit mata uang asing Visa/Mastercard, atau melalui layanan kartu kredit virtual.

Langkah 4: Menulis Kode untuk Memanggil API

from google import genai
from google.genai import types

# Inisialisasi klien dengan kunci API Anda
client = genai.Client(api_key="YOUR_AI_STUDIO_KEY")

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents=["Seekor anjing golden retriever berlari di pantai, sinar matahari sore"],
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(
            image_size="4K",
            aspect_ratio="16:9"
        ),
    )
)

# Simpan hasil gambar
for part in response.parts:
    if image := part.as_image():
        image.save("output.png", format="PNG")

Langkah 5: Memantau Penggunaan dan Biaya

Item Pemantauan Lokasi Tampilan
Sisa Kredit AI Studio → Billing → Available Credits
Detail Penggunaan AI Studio → Billing → Usage
Isi Saldo Otomatis Dapat mengaktifkan Auto-reload (isi ulang otomatis jika saldo di bawah ambang batas)

Seluruh proses memakan waktu sekitar 30-45 menit (termasuk waktu tunggu verifikasi kartu kredit).

Alur 2: Pembelian dan Akses Vertex AI (Tingkat Perusahaan)

Vertex AI sangat cocok bagi pengguna korporat yang membutuhkan SLA, kontrol izin IAM, dan sertifikasi kepatuhan.

Ringkasan Langkah Akses Vertex AI

Langkah Operasi Durasi
1 Membuat akun Google Cloud 10 menit
2 Membuat proyek GCP 5 menit
3 Menautkan kartu kredit (Wajib) 10 menit
4 Mengaktifkan API Vertex AI 5 menit
5 Membuat akun layanan + unduh JSON kredensial 15 menit
6 Mengonfigurasi izin IAM (roles/aiplatform.user) 15 menit
7 Menginstal gcloud CLI + autentikasi 30 menit
8 Menulis kode untuk pemanggilan 30 menit

Total durasi sekitar 2-3 jam.

Harga Vertex AI

Sama persis dengan AI Studio—2K $0,067/gambar, 4K $0,151/gambar. Tanpa diskon.

Nilai tambah yang didapatkan dari Vertex AI adalah: jaminan SLA 99,9%, izin IAM yang mendetail, isolasi jaringan VPC, dan kuota RPM yang dapat disesuaikan.

Batasan Jaringan Vertex AI

Sama seperti AI Studio—Tiongkok daratan dan Rusia tidak dapat terhubung langsung ke aiplatform.googleapis.com. Pengguna perusahaan biasanya perlu menyebarkan server perantara di Singapura atau Jepang untuk melakukan penerusan proksi.

nano-banana-2-api-access-guide-billing-flow-apiyi-alternative-id 图示

Solusi Cadangan APIYI: Mengapa Harus Menggunakan "Sistem Jalur Ganda"?

Beberapa pengembang bertanya: Jika APIYI lebih murah dan lebih mudah digunakan, mengapa kita masih perlu mempertahankan koneksi langsung ke penyedia resmi?

Skenario di mana koneksi resmi dapat menjadi cadangan

Skenario Penjelasan
Audit Kepatuhan Beberapa perusahaan mewajibkan penggunaan vendor pihak pertama secara langsung
Jaminan SLA Vertex AI memiliki kontrak SLA 99,9%
Pemeliharaan APIYI Meskipun jarang, platform proksi juga bisa memiliki jendela pemeliharaan
Parameter Khusus Fitur tertentu yang eksklusif di Vertex AI (seperti outputMimeType)

Skenario di mana APIYI dapat menjadi cadangan (lebih banyak)

Skenario Penjelasan
Crash Resmi 503 Tingkat kesalahan 45% saat jam sibuk → APIYI otomatis mencoba ulang melalui banyak saluran
Pemangkasan Kuota Antigravity Dipangkas 4 kali dalam 4 bulan → APIYI tidak terpengaruh
Tidak Bisa Terhubung di Tiongkok/Rusia APIYI terhubung secara global, tanpa perlu VPN
Tidak Ada Kartu Kredit Luar Negeri APIYI mendukung berbagai metode pembayaran
Penghematan Biaya Massal 4K $0,045 vs Resmi $0,151, hemat 70%
Peluncuran Cepat Integrasi 5 menit vs Resmi 30 menit-3 jam

Arsitektur yang disarankan: Prioritaskan APIYI (hemat biaya + stabil), gunakan koneksi resmi sebagai cadangan (tentu saja, jika pihak resmi yang tumbang, tidak ada yang bisa dilakukan).

Kode Integrasi APIYI (hanya beda satu baris dari kode resmi)

import openai

# Integrasi APIYI: ubah satu baris base_url
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": "Seekor anjing golden retriever berlari di pantai, sinar matahari sore"
    }]
)

Lihat kode degradasi sistem jalur ganda
import openai

# Utama: APIYI (murah + stabil)
apiyi_client = openai.OpenAI(
    api_key="APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# Cadangan: Koneksi resmi
from google import genai
official_client = genai.Client(api_key="GOOGLE_KEY")

def generate_image(prompt: str):
    """Sistem jalur ganda: APIYI diprioritaskan, jika gagal turunkan ke resmi"""
    try:
        # Pilihan pertama: APIYI ($0,045/gambar, stabil)
        response = apiyi_client.chat.completions.create(
            model="gemini-3.1-flash-image-preview",
            messages=[{"role": "user", "content": prompt}]
        )
        return response, "apiyi"
    except Exception as e:
        print(f"APIYI gagal: {e},beralih ke koneksi resmi...")
        try:
            # Cadangan: Koneksi resmi ($0,151/gambar)
            from google.genai import types
            response = official_client.models.generate_content(
                model="gemini-3.1-flash-image-preview",
                contents=[prompt],
                config=types.GenerateContentConfig(
                    response_modalities=["TEXT", "IMAGE"],
                ),
            )
            return response, "official"
        except Exception as e2:
            print(f"Pihak resmi juga gagal: {e2} (jika resmi tumbang, memang tidak ada cara lain)")
            return None, "both_failed"

🎯 Saran Arsitektur: Gunakan APIYI untuk kebutuhan sehari-hari (hemat biaya + stabil), sambil tetap menyimpan jalur kode koneksi resmi. Jika APIYI mati, pindah ke resmi; jika resmi mati, pindah ke APIYI—saling menjadi cadangan, bisnis tidak akan pernah terputus (kecuali keduanya mati bersamaan, yang berarti ada kegagalan infrastruktur di tingkat Google, yang tidak bisa diatasi siapa pun).


Perbedaan Integrasi Resmi Nano Banana 2 vs Nano Banana Pro

Jika Anda sudah membaca artikel NB Pro sebelumnya, berikut adalah perbedaan utama integrasi NB2:

Poin Perbedaan Nano Banana Pro Nano Banana 2
ID Model gemini-3-pro-image-preview gemini-3.1-flash-image-preview
Tingkat Gratis Hampir nol Gratis terbatas (~500 RPD Flash Image)
Harga Resmi 4K $0,24/gambar $0,151/gambar (lebih murah 37%)
Harga APIYI $0,05/permintaan tetap $0,045/permintaan tetap
Diskon APIYI Di bawah 20% Sekitar 28%
Kecepatan 10-20 detik/1K 4-6 detik/1K (3x lebih cepat)
Sistem Penagihan Sama dengan NB2 (Sistem baru 23.3.2026) Sistem prabayar/pascabayar
Kualitas Gambar 100% (dasar) ~95% (sangat mendekati)

nano-banana-2-api-access-guide-billing-flow-apiyi-alternative-id 图示


Pertanyaan Umum

Q1: Apa perubahan pada sistem penagihan baru AI Studio dibandingkan sebelumnya?

Mulai 23 Maret 2026, AI Studio beralih dari sistem yang terhubung dengan penagihan GCP menjadi sistem prabayar/pascabayar bawaan. Prabayar dimulai dari minimal $10 dengan dukungan isi ulang otomatis. Pascabayar memerlukan verifikasi kredit. Perubahan ini menyederhanakan proses penagihan—tidak perlu lagi repot di konsol GCP. Namun, persyaratan kartu kredit tetap sama, kartu UnionPay Tiongkok masih belum diterima.

Q2: Saya sudah menggunakan koneksi langsung AI Studio, apakah masih perlu menggunakan APIYI?

Sangat disarankan. APIYI tidak dimaksudkan untuk menggantikan layanan resmi, melainkan sebagai cadangan dan penghematan biaya: 1) Saat layanan resmi mengalami crash 503 (probabilitas 45% pada jam sibuk), bisnis Anda tidak akan terputus; 2) Saat Antigravity memangkas kuota (4 kali dalam 4 bulan), APIYI tidak terpengaruh; 3) Untuk tugas batch harian, gunakan APIYI, $0,045 per 4K vs $0,151 resmi, hemat 70%. Cukup tambahkan logika try/except untuk fallback di kode Anda, hanya butuh dua baris kode.

Q3: Apa perbedaan antara koneksi langsung APIYI dan situs resmi? Kapan sebaiknya menggunakan APIYI?

APIYI juga pada akhirnya merutekan ke infrastruktur model Google—kualitas gambar benar-benar identik. Skenario di mana APIYI lebih baik: 1) Anda berada di wilayah terbatas seperti Tiongkok/Rusia (resmi tidak bisa diakses langsung); 2) Anda tidak memiliki kartu kredit luar negeri; 3) Anda perlu melakukan pembuatan gambar dalam jumlah besar (APIYI tidak membatasi RPM); 4) Anda sensitif terhadap biaya (diskon hingga 28%); 5) Anda perlu beralih antar model (satu kunci mencakup NB2 + NB Pro + Claude). Skenario di mana layanan resmi lebih baik: kebutuhan audit kepatuhan untuk menggunakan vendor pihak pertama, atau memerlukan SLA Vertex AI.

Q4: Apa maksud dari “Jika layanan resmi tumbang, tidak ada yang bisa dilakukan”?

Penyeimbang beban multi-saluran APIYI dapat menjaga layanan tetap berjalan saat sebagian node Google mengalami kegagalan—secara otomatis mencoba ulang pada node yang tersedia. Namun, jika seluruh infrastruktur model Nano Banana 2 Google mengalami crash total (semua node mati bersamaan), maka memang tidak ada yang bisa dilakukan—karena semua saluran pada akhirnya bergantung pada model Google. Situasi ekstrem ini sangat jarang terjadi (belum pernah terjadi crash total sejak 2026), namun jujur mengenai batasan ini jauh lebih bertanggung jawab daripada menjanjikan "100% tidak akan ada masalah".


Kesimpulan

Poin utama integrasi API Nano Banana 2:

  1. Dua jalur resmi memerlukan kartu kredit dan harga penuh: AI Studio bisa digunakan dalam 30 menit tetapi butuh kartu kredit luar negeri + harga penuh $0,151/gambar; Vertex AI butuh 2-3 jam tetapi memiliki SLA. Keduanya tidak bisa diakses langsung dari Tiongkok/Rusia.
  2. APIYI adalah solusi terbaik untuk cadangan dan penghematan: Integrasi 5 menit, $0,045/gambar 4K (diskon 28%), akses langsung global, tidak perlu kartu kredit luar negeri, penagihan sesuai pemakaian, kegagalan tidak dikenakan biaya. Memenuhi sebagian besar kebutuhan bisnis.
  3. Arsitektur jalur ganda adalah yang paling aman: Gunakan APIYI untuk penghematan harian, simpan jalur kode resmi sebagai cadangan. Keduanya saling membackup, bisnis tidak akan pernah terputus (jika layanan resmi tumbang memang tidak ada yang bisa dilakukan, tetapi crash total seperti itu sangat jarang terjadi).

Direkomendasikan untuk mengakses API Nano Banana 2 melalui APIYI di apiyi.com—$0,045/gambar 4K, akses langsung global, mulai dalam 5 menit, dan dapatkan kuota uji coba gratis setelah mendaftar.


📚 Referensi

  1. Panduan Pengembang Resmi Nano Banana 2: Tutorial akses dan penggunaan NB2 dari Google

    • Tautan: blog.google/innovation-and-ai/technology/developers-tools/build-with-nano-banana-2/
    • Penjelasan: Berisi kemampuan model, contoh kode, dan praktik terbaik
  2. Dokumentasi Penagihan AI Studio: Sistem penagihan prabayar/pascabayar yang baru

    • Tautan: ai.google.dev/gemini-api/docs/billing
    • Penjelasan: Penjelasan mendetail mengenai sistem baru per 23 Maret 2026
  3. Batas Kecepatan Gemini API: Penjelasan resmi mengenai batas kecepatan dan tingkatan (tier)

    • Tautan: ai.google.dev/gemini-api/docs/rate-limits
    • Penjelasan: Kuota spesifik untuk tingkat gratis/Tier 1/Tier 2/Tier 3
  4. Pusat Dokumentasi APIYI: Panduan akses Nano Banana 2 seharga $0,045/4K

    • Tautan: docs.apiyi.com
    • Penjelasan: Akses dalam 5 menit + koneksi langsung global + penagihan sesuai penggunaan + tidak ada biaya jika gagal

Penulis: Tim Teknis APIYI
Diskusi Teknis: Silakan berdiskusi di kolom komentar, untuk materi lebih lanjut kunjungi pusat dokumentasi APIYI di docs.apiyi.com

Similar Posts