Kunci API Gemini — cara mendapatkannya dan menggunakannya dengan SDK OpenAI

Kunci API Gemini adalah kredensial yang mengautentikasi panggilan Anda ke model Gemini Google: setiap permintaan membawa kunci dalam header Authorization, dan penggunaan diukur serta ditagih berdasarkan token. Ada dua cara untuk mendapatkan kunci yang berfungsi: Google AI Studio (resmi), yang menyediakan kunci khusus Gemini, atau Kunavo, tempat satu kunci yang kompatibel dengan OpenAI dapat mengakses Gemini, Claude, GPT, serta model gambar, video, dan audio—tanpa memerlukan proyek Google Cloud. Panduan ini menunjukkan cara memperoleh kunci melalui kedua jalur dan cara melakukan panggilan pertama.

Opsi 1 — Google AI Studio (resmi)

Ini adalah pilihan yang tepat jika Gemini adalah satu-satunya model yang akan Anda panggil.

1. Masuk ke aistudio.google.com dengan akun Google.
2. Buka Get API key → Create API key. Kunci memiliki format AIza....
3. Tingkat gratis memiliki batasan dan cocok untuk prototipe. Untuk volume produksi, Anda perlu mengaitkan kunci dengan project Google Cloud yang telah mengaktifkan akun billing.

Jika Anda juga menggunakan Claude, gambar, atau video, pilihan ini membuat Anda mengelola satu kunci, satu SDK, dan satu tagihan terpisah untuk setiap penyedia.

Opsi 2 — Kunavo (direkomendasikan untuk produksi)

Kunavo menempatkan Gemini di balik API yang kompatibel dengan OpenAI. Satu kunci sk-kn- dapat memanggil Gemini dan semua model lainnya, dengan satu saldo yang ditagihkan melalui Stripe dan tanpa project Google Cloud apa pun. Harga Gemini sekitar 70% lebih rendah daripada harga resmi Google — Flash, misalnya, berharga $0,09 per 1 juta token input dan $0,75 per 1 juta token output. Model ini menggunakan pay-as-you-go mulai dari setoran minimum $10, dan saldo tidak pernah kedaluwarsa.

1. Daftar di kunavo.com.
2. Setor $10 — pay-as-you-go, saldo tidak pernah kedaluwarsa.
3. Buat kunci di /app/keys. Kunci diawali dengan sk-kn- dan hanya ditampilkan sekali; simpan dalam variabel lingkungan.
4. Lakukan pemanggilan dengan mengarahkan SDK OpenAI ke https://api.kunavo.com/v1 dan menggunakan slug Gemini.

Panduan mulai cepat

Pertahankan SDK resmi OpenAI. Ubah base_url dan nama model — tidak ada yang lain:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

Keamanan kunci

• Jangan pernah mengekspos kunci di sisi klien. Bundle browser dan mobile bersifat publik — selalu gunakan proxy melalui server Anda sendiri. Simpan kunci dalam variabel lingkungan, di luar kode yang diberi versi.
• Gunakan satu kunci per project atau lingkungan, agar kebocoran dapat dicabut tanpa melumpuhkan bagian lainnya.
• Lakukan rotasi secara berkala. Kunavo mengizinkan beberapa kunci aktif secara bersamaan, sehingga rotasi dapat dilakukan melalui tumpang tindih yang mulus, bukan pemutusan mendadak.
• Tetapkan batas pengeluaran per kunci di dashboard dan pantau /app/usage untuk mendeteksi lalu lintas tak terduga, yang dirinci berdasarkan kunci.

Pertanyaan umum