Cara mendapatkan kunci API Gemini — dua cara melalui Google AI Studio dan Kunavo

Kunci API Gemini adalah kredensial bearer untuk mengautentikasi panggilan ke model Gemini milik Google. Ada dua cara untuk mendapatkannya — melalui Google AI Studio (resmi), atau menggunakan satu kunci kompatibel OpenAI dari Kunavo untuk memanggil Gemini, Claude, GPT, serta model gambar/video melalui kunci yang sama (tanpa memerlukan proyek Google Cloud). Panduan ini menjelaskan kedua prosedur dan pilihan yang sebaiknya digunakan dalam produksi.

Metode 1 — Google AI Studio (resmi)

Jika Anda hanya menggunakan Gemini, cara standar adalah memperoleh kunci langsung dari Google.

1. Masuk ke aistudio.google.com dengan akun Google Anda.
2. Buka Dapatkan kunci API → Buat kunci API. Kunci memiliki format seperti AIza....
3. Untuk prototipe, Anda dapat menggunakan paket gratis dengan batas laju. Untuk volume produksi, Anda perlu menautkan kunci ke proyek Google Cloud yang telah mengaktifkan penagihan.

Jika model yang Anda panggil hanya Gemini, inilah jalur yang tepat. Namun, jika Anda juga menggunakan model Claude atau gambar/video, Anda harus mengelola kunci, SDK, dan tagihan terpisah untuk setiap penyedia.

Metode 2 — Kunavo (direkomendasikan untuk produksi)

Kunavo menempatkan Gemini di balik API yang kompatibel dengan OpenAI. Dengan satu kunci sk-kn-, Anda dapat mengakses Gemini dan semua model lainnya; proyek Google Cloud tidak diperlukan, dan pembayaran digabungkan dalam satu saldo Stripe. Gemini sekitar 70% lebih murah daripada harga resmi Google, dan penagihan sesuai pemakaian dimulai dari $10.

1. Daftar — buat akun di kunavo.com.
2. Isi saldo $10 — penagihan sesuai pemakaian dan saldo tidak kedaluwarsa.
3. Buat kunci — buat kunci di /app/keys. Kunci dimulai dengan sk-kn- dan hanya ditampilkan sekali, jadi simpan di variabel lingkungan.
4. Lakukan panggilan — arahkan base_url dari OpenAI SDK ke https://api.kunavo.com/v1 dan tentukan slug Gemini.

Anda juga dapat memeriksa metode yang lebih sesuai melalui tabel perbandingan di dokumentasi kunci Gemini API. Untuk rincian harga, lihat panduan harga Gemini API.

Mulai cepat

Gunakan OpenAI SDK resmi sebagaimana adanya. Yang diubah hanya base_url dan nama model.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)

Pengelolaan kunci yang aman

• Gunakan variabel lingkungan. Jangan menulis kunci langsung dalam kode; baca kunci dari variabel lingkungan seperti KUNAVO_API_KEY. Karena bundel browser dan aplikasi seluler tersedia untuk publik, jangan mengekspos kunci di sisi klien dan selalu teruskan permintaan melalui server Anda sendiri sebagai proksi.
• Rotasi kunci secara berkala. Kunavo memungkinkan beberapa kunci aktif secara bersamaan, sehingga rotasi dapat dilakukan dengan masa penggunaan yang tumpang tindih secara mulus, bukan pergantian mendadak. Jadikan rotasi setiap kuartal sebagai pedoman.
• Tetapkan batas untuk setiap kunci. Dengan menetapkan batas per kunci di dasbor dan memisahkan kunci berdasarkan proyek atau lingkungan, Anda dapat mencabut hanya kunci yang bocor tanpa menghentikan seluruh sistem. Pantau lalu lintas setiap kunci di /app/usage.

Pertanyaan yang sering diajukan