API key Gemini — cara mendapatkannya dan menggunakannya dengan SDK OpenAI

Gemini API key adalah kredensial untuk 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 mendapatkan kunci melalui kedua jalur dan cara melakukan panggilan pertama.

Pilihan 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 menggunakan akun Google.
2. Buka Get API key → Create API key. Kunci berformat AIza....
3. Tingkat gratis memiliki batasan dan cocok untuk prototipe. Untuk beban produksi, kunci harus dikaitkan dengan proyek Google Cloud yang telah mengaktifkan akun penagihan.

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

Pilihan 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 dompet yang ditagih melalui Stripe dan tanpa memerlukan proyek Google Cloud apa pun. Harga Gemini sekitar 70% lebih rendah daripada harga resmi Google—misalnya, Flash berharga $0,09 per 1 juta token input dan $0,75 per 1 juta token output. Ini adalah pembayaran sesuai pemakaian mulai dari pengisian minimum $10, dan saldo tidak pernah kedaluwarsa.

1. Daftar di kunavo.com.
2. Isi $10—bayar sesuai pemakaian, dan saldo tidak pernah kedaluwarsa.
3. Buat kunci di /app/keys. Kunci dimulai dengan sk-kn- dan hanya ditampilkan sekali; simpan dalam variabel lingkungan.
4. Lakukan panggilan dengan mengarahkan SDK OpenAI ke https://api.kunavo.com/v1 dan menggunakan slug Gemini.

Panduan mulai cepat

Pertahankan SDK OpenAI resmi. Ubah base_url dan nama model—hanya itu:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # dòng duy nhất thay đổi
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Giải thích RAG trong hai câu."}],
)
print(resp.choices[0].message.content)

Keamanan kunci

• Jangan pernah mengekspos kunci di sisi klien. Bundle browser dan mobile bersifat publik—selalu lakukan proxy melalui server Anda sendiri. Simpan kunci dalam variabel lingkungan, di luar kode yang dikelola versinya.
• Gunakan satu kunci untuk setiap proyek atau lingkungan, sehingga jika terjadi kebocoran Anda dapat mencabutnya tanpa melumpuhkan bagian lainnya.
• Putar kunci secara berkala. Kunavo memungkinkan beberapa kunci aktif secara bersamaan, sehingga rotasi kunci menjadi perpindahan yang mulus, bukan pemutusan mendadak.
• Tetapkan batas pengeluaran per kunci di dashboard dan pantau /app/usage untuk mendeteksi lalu lintas yang tidak biasa, dengan pemisahan berdasarkan kunci.

Pertanyaan umum