Kunci API Gemini — cara mendapatkannya dan menggunakannya dengan SDK OpenAI

Kunci API Gemini mengautentikasi panggilan Anda ke model Gemini milik Google: setiap permintaan menyertakan kunci di header Authorization, dan platform mengukur serta menagihkan penggunaan melalui kunci tersebut. Ada dua cara untuk mendapatkan kunci API Gemini — langsung melalui Google AI Studio (cara resmi), atau melalui Kunavo: kunci yang kompatibel dengan OpenAI untuk mengakses Gemini serta Claude, GPT, dan model gambar dan video, tanpa proyek Google Cloud apa pun.

Opsi 1 — Google AI Studio (resmi)

Jika Gemini adalah satu-satunya model yang akan pernah Anda panggil, dapatkan kuncinya langsung dari Google:

1. Buka aistudio.google.com dan masuk dengan akun Google.
2. Buka Get API key → Create API key. Kunci dimulai dengan AIza… dan hanya ditampilkan sekali.
3. Tingkat gratis memiliki batas laju dan cocok untuk pembuatan prototipe. Untuk produksi, tautkan kunci ke akun penagihan Google Cloud.

Ini adalah cara yang tepat selama Anda hanya memerlukan Gemini. Begitu Anda juga menggunakan Claude, GPT, atau model gambar dan video, Anda harus mengelola satu kunci, satu SDK, dan satu tagihan untuk setiap penyedia.

Opsi 2 — Kunavo (direkomendasikan untuk produksi)

Kunavo menempatkan Gemini di balik API yang kompatibel dengan OpenAI. Satu kunci sk-kn- mengakses semua model melalui endpoint yang sama — tanpa proyek Google Cloud, Gemini sekitar 70% di bawah harga daftar Google ($0,09 / $0,75 per 1 juta token), satu saldo Stripe, pay-as-you-go mulai dari pengisian $10. Saldo tersebut mencakup Gemini, Claude, GPT, gambar, dan video secara bersamaan, serta tidak pernah kedaluwarsa.

1. Daftar. Buat akun Kunavo di kunavo.com.
2. Isi saldo $10. Pay-as-you-go mulai dari pengisian minimum $10; saldo tidak pernah kedaluwarsa.
3. Buat kunci. Buat kunci di /app/keys. Kunci dimulai dengan sk-kn- dan hanya ditampilkan sekali — simpan dalam variabel lingkungan.
4. Lakukan panggilan. Arahkan SDK OpenAI ke https://api.kunavo.com/v1 dan panggil slug Gemini.

Panduan mulai cepat

Pertahankan SDK OpenAI resmi. Anda hanya perlu mengubah 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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

Pola yang sama berlaku untuk Node.js dan curl; harga per model serta contoh terperinci tersedia di panduan harga API Gemini.

Menjaga keamanan kunci

• Variabel lingkungan, bukan kode sumber. Jangan pernah melakukan commit kunci ke repositori; baca kunci dari variabel lingkungan. Jangan pernah mengeksposnya dalam bundle browser atau seluler — selalu gunakan server Anda sendiri sebagai perantara.
• Satu kunci per proyek atau lingkungan. Dengan demikian, kunci yang bocor dapat dicabut tanpa merusak hal lain.
• Rotasi secara berkala. Kunavo mengizinkan beberapa kunci aktif, sehingga rotasi dapat dilakukan dengan tumpang tindih yang mulus, bukan pemutusan mendadak.
• Batas pengeluaran per kunci. Tetapkan batas per kunci di dasbor dan pantau lalu lintas tak terduga berdasarkan kunci di /app/usage.

Pertanyaan umum