Gemini API key — cara mendapatkan dan memakainya dengan SDK OpenAI

Sebuah Gemini API key adalah kredensial yang mengautentikasi panggilan Anda ke model Gemini milik Google: setiap permintaan membawa kunci di header Authorization, dan penggunaannya diukur serta ditagih per token. Ada dua jalur untuk mendapatkan kunci yang berfungsi: Google AI Studio (resmi), yang memberi kunci khusus Gemini, atau Kunavo, di mana satu kunci kompatibel-OpenAI menjangkau Gemini, Claude, GPT, serta model gambar, video, dan audio — tanpa perlu proyek Google Cloud. Panduan ini menunjukkan cara mendapatkan kunci lewat kedua jalur dan cara membuat panggilan pertama.

Opsi 1 — Google AI Studio (resmi)

Ini jalur 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 berformat AIza....
3. Tier gratis terbatas dan cocok untuk prototipe. Untuk volume produksi, kunci perlu ditautkan ke proyek Google Cloud dengan akun billing yang aktif.

Jika Anda juga memakai Claude, gambar, atau video, jalur ini membuat Anda mengelola kunci, SDK, dan tagihan terpisah per penyedia.

Opsi 2 — Kunavo (disarankan untuk produksi)

Kunavo menempatkan Gemini di balik API yang kompatibel dengan OpenAI. Satu kunci sk-kunavo- memanggil Gemini dan semua model lain, dengan satu dompet yang ditagih via Stripe dan tanpa proyek Google Cloud apa pun. Gemini keluar sekitar 70% di bawah harga list resmi Google — Flash, misalnya, berharga $0.09 per 1J token masukan dan $0.75 per 1J keluaran. Ini pay-as-you-go mulai dari top-up minimum $5, dan saldo tidak pernah hangus.

1. Daftar di kunavo.com.
2. Top-up $5 — pay-as-you-go, saldo tidak pernah hangus.
3. Buat kunci di /app/keys. Kunci diawali sk-kunavo- dan hanya ditampilkan sekali; simpan dalam variabel lingkungan.
4. Panggil dengan mengarahkan SDK OpenAI ke https://api.kunavo.com/v1 dan memakai slug Gemini.

Quickstart

Tetap pakai SDK resmi OpenAI. Ubah base_url dan nama model — tidak lebih:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # satu-satunya baris yang berubah
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Jelaskan RAG dalam dua kalimat."}],
)
print(resp.choices[0].message.content)

Keamanan kunci

• Jangan pernah mengekspos kunci di sisi klien. Bundle peramban dan mobile bersifat publik — selalu proksikan lewat server Anda sendiri. Simpan kunci dalam variabel lingkungan, di luar kode yang diversiokan.
• Gunakan satu kunci per proyek atau lingkungan, agar satu kebocoran bisa dicabut tanpa menumbangkan yang lain.
• Rotasi secara berkala. Kunavo mengizinkan beberapa kunci aktif sekaligus, sehingga rotasi menjadi peralihan yang mulus, bukan pemutusan mendadak.
• Setel batas pengeluaran per kunci di dashboard dan pantau /app/usage untuk menandai trafik tak terduga, terurai per kunci.

FAQ

Apakah Gemini API gratis?

Google AI Studio menerbitkan kunci tier gratis dengan batas rendah, bagus untuk prototipe; produksi pindah ke billing berbayar di Google Cloud. Di Kunavo ini pay-as-you-go mulai dari top-up minimum $5, tanpa akun billing Google Cloud, dan saldo tidak pernah hangus.

Bisakah mendapatkan kunci tanpa akun Google Cloud?

Bisa. Di Kunavo Anda membuat kunci sk-kunavo- dan memanggil Gemini lewat endpoint yang kompatibel dengan OpenAI, tanpa membuka proyek atau mengaktifkan billing di Google Cloud.

Kunci Gemini vs kunci Kunavo?

Kunci Google hanya memanggil Gemini dan ditagih lewat akun Google Cloud. Kunci Kunavo memanggil Gemini plus Claude, GPT, serta model gambar, video, dan audio lewat satu API yang kompatibel dengan OpenAI, dengan satu dompet via Stripe. Untuk tarif per model dan contoh biaya, lihat panduan harga Gemini API.