Cara menerbitkan kunci API Gemini — Google AI Studio vs Kunavo

Kunci API Gemini adalah kredensial bearer untuk mengautentikasi panggilan ke model Gemini milik Google. Ada dua cara untuk mendapatkan kunci — memperoleh kunci resmi dari Google AI Studio, atau menggunakan Kunavo untuk mengakses Gemini, Claude, GPT, serta model gambar/video dengan satu kunci yang kompatibel dengan OpenAI (tanpa memerlukan proyek Google Cloud). Panduan ini membandingkan kedua cara tersebut dan menunjukkan cara tercepat untuk langsung mulai melakukan panggilan dalam lingkungan produksi.

Cara 1 — Google AI Studio (resmi)

Jika Anda berencana hanya menggunakan Gemini, mendapatkan kunci langsung dari Google adalah pilihan yang sesuai.

1. Kunjungi aistudio.google.com dan masuk dengan akun Google.
2. Buat kunci melalui Get API key → Create API key. Kunci memiliki format AIza....
3. Tingkat gratis untuk prototipe memiliki batas permintaan dan cocok untuk pengembangan awal.
4. Untuk menangani volume penggunaan produksi, Anda harus menghubungkan kunci ke akun penagihan Google Cloud yang penagihannya telah diaktifkan.

Cara ini sesuai jika Gemini akan tetap menjadi satu-satunya model yang Anda gunakan. Namun, jika Anda juga menggunakan Claude atau model gambar/video, Anda harus mengelola kunci, SDK, dan faktur terpisah untuk setiap penyedia.

Cara 2 — Kunavo (disarankan untuk produksi)

Kunavo menyediakan Gemini melalui endpoint yang kompatibel dengan OpenAI. Anda dapat mengakses semua model dengan satu kunci sk-kn- dan membayar menggunakan satu saldo Stripe, sehingga tidak memerlukan proyek Google Cloud. Harga Gemini sekitar 70% lebih murah daripada harga resmi Google, saldo tidak kedaluwarsa, dan Anda membayar sesuai penggunaan dengan isi ulang minimum $10.

1. Daftar — buat akun di kunavo.com.
2. Isi saldo $10 — bayar sesuai penggunaan, dan saldo tidak pernah kedaluwarsa.
3. Buat kunci — buat kunci di /app/keys. Kunci diawali dengan sk-kn- dan hanya ditampilkan sekali, jadi simpan dalam variabel lingkungan.
4. Panggil — atur base_url pada OpenAI SDK ke https://api.kunavo.com/v1 dan panggil slug Gemini.

Mulai cepat

Gunakan OpenAI SDK resmi sebagaimana adanya. Cukup ubah base_url dan nama model — tidak ada hal lain yang perlu diubah.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

Mengelola kunci dengan aman

• Gunakan variabel lingkungan. Jangan menuliskan kunci secara langsung dalam kode; simpan dalam variabel lingkungan seperti KUNAVO_API_KEY. Karena bundel browser atau aplikasi seluler dapat diakses publik, jangan pernah mengekspos kunci di sisi klien dan selalu gunakan server Anda sendiri sebagai proksi.
• Rotasi kunci secara berkala. Kunavo mengizinkan beberapa kunci aktif, sehingga rotasi dapat dilakukan dengan masa penggunaan yang tumpang tindih secara mulus, bukan pergantian mendadak. Rotasi setiap kuartal disarankan.
• Tetapkan batas pengeluaran per kunci. Tetapkan batas pengeluaran untuk setiap kunci di dasbor dan periksa penggunaan per kunci di /app/usage, sehingga jika sebuah kunci bocor, Anda dapat mencabutnya tanpa memengaruhi kunci lain.

Pertanyaan yang sering diajukan