Nano Banana API — tetap menggunakan OpenAI SDK, harga per gambar dan cara pemanggilan

Jika Anda mencari API Nano Banana dalam bahasa Korea, hasilnya terbagi menjadi dua: dokumentasi resmi Google atau artikel blog tentang “cara mendapatkan kunci di AI Studio”. Yang sebenarnya dibutuhkan berada di antara keduanya. Artikel ini merangkum cara melakukan panggilan tanpa mengganti SDK OpenAI yang sudah digunakan serta harga per gambar untuk seluruh keluarga model dalam satu tabel. Proyek Google Cloud tidak diperlukan.

Harga per gambar — seluruh keluarga model

Tarif di bawah ini diambil dari katalog model, bukan dimasukkan secara manual ke dalam artikel. Jika harga berubah, tabel ini juga ikut berubah.

Semuanya berdasarkan per image, dan biaya dipotong dari saldo prabayar, bukan melalui langganan. Tidak ada tagihan pada bulan ketika Anda tidak menghasilkan gambar.

Melakukan panggilan — ganti base_url dan nama model saja

Jika Anda sudah menggunakan SDK OpenAI, tidak ada hal baru yang perlu dipelajari. Hanya dua bagian yang berubah: base_url pada inisialisasi klien dan nama model.

# 기존 OpenAI SDK를 그대로 씁니다. base_url과 모델 이름만 바뀝니다.
# Google Cloud 프로젝트도, 별도 SDK 설치도 필요 없습니다.
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key=os.environ["KUNAVO_API_KEY"],
)

img = client.images.generate(
    model="nano-banana-2",
    prompt="한옥 마당에 눈이 내리는 장면, 따뜻한 조명, 사진 스타일",
    n=1,
)
print(img.data[0].url)

Endpoint-nya adalah POST /v1/images/generations, dengan format yang sama seperti endpoint gambar OpenAI. Jadi, jika kode Anda sudah mengintegrasikan pembuatan gambar, Anda dapat beralih cukup dengan mengganti satu string nama model.

Periksa terlebih dahulu apakah kunci Anda berfungsi

Jika Anda memeriksa kunci dan alamat dengan satu permintaan sebelum mengubah kode, saat terjadi kesalahan kemudian Anda dapat mempersempit penyebabnya ke bagian kode.

# 키가 되는지 30초 만에 확인하는 최소 요청
curl -sS https://api.kunavo.com/v1/images/generations \
  -H "Authorization: Bearer sk-kn-..." \
  -H "content-type: application/json" \
  -d '{"model":"nano-banana","prompt":"a paper crane on a desk","n":1}'

401 menunjukkan masalah autentikasi, 429 menunjukkan pembatasan laju, dan 529 menunjukkan kelebihan beban upstream. Untuk membedakannya, tabel keputusan dalam Ringkasan kesalahan Claude Code dapat diterapkan langsung.

Tingkatan mana yang sebaiknya dijadikan pilihan default?

Cara yang paling hemat biaya adalah menjadikan model dasar sebagai pilihan default dan beralih ke Pro hanya ketika hasilnya kurang memadai. Karena Anda hanya perlu mengganti satu string nama model, manfaatkan fakta bahwa biaya eksperimen perbandingan praktis tidak ada — jalankan prompt yang sama sekali pada masing-masing dari kedua tingkatan, lalu tentukan pilihan.

Tarif video tersedia di Harga Veo 3, sedangkan dokumentasi terperinci dalam bahasa Inggris tersedia di Nano Banana API. Metode pembayaran dan pendaftaran kartu Korea dirangkum di Harga dan pembayaran Claude API.

Pertanyaan yang sering diajukan