Cara mendapatkan kunci API Gemini — langkah demi langkah dengan Google AI Studio dan Kunavo

Kunci Gemini API adalah kredensial bearer yang mengautentikasi panggilan Anda ke model Gemini milik Google. Ada dua cara untuk mendapatkannya: langsung dari Google AI Studio (cara resmi) atau melalui Kunavo — satu kunci yang kompatibel dengan OpenAI untuk Gemini, Claude, GPT, serta gambar/video, tanpa menyiapkan project Google Cloud. Panduan ini menjelaskan kedua cara tersebut langkah demi langkah dan membantu Anda memanggil Gemini dalam hitungan menit.

Opsi 1 — Google AI Studio (resmi)

Jika Anda hanya akan menggunakan Gemini, Anda dapat memperoleh kunci langsung dari Google:

1. Masuk ke aistudio.google.com dengan akun Google.
2. Ikuti jalur Get API key → Create API key. Kunci diawali dengan AIza....
3. Tersedia tingkat gratis terbatas dengan batas kecepatan untuk pembuatan prototipe.
4. Untuk volume produksi, Anda harus mengaitkan kunci dengan project Google Cloud yang penagihannya telah diaktifkan.

Ini adalah pilihan yang tepat jika Gemini adalah satu-satunya model yang akan Anda panggil. Jika Anda juga menggunakan Claude, gambar, atau video, Anda perlu mengelola kunci, SDK, dan tagihan terpisah untuk setiap penyedia.

Opsi 2 — Kunavo (direkomendasikan untuk produksi)

Kunavo menyediakan Gemini di balik API yang kompatibel dengan OpenAI. Satu kunci sk-kn- dapat mengakses Gemini dan setiap model lainnya (melalui endpoint yang kompatibel dengan OpenAI) — tanpa project Google Cloud. Harga Gemini sekitar 70% lebih rendah daripada harga resmi Google, satu saldo Stripe mencakup semuanya, dan Anda mulai dengan pay-as-you-go $10.

1. Buat akun Kunavo dan setor $10 — pay-as-you-go, saldo tidak pernah kedaluwarsa.
2. Buat kunci di /app/keys. Kunci hanya ditampilkan sekali; simpan dalam variabel lingkungan.
3. Arahkan OpenAI SDK ke https://api.kunavo.com/v1 dan panggil slug Gemini.
4. Lakukan pemanggilan — kirim field model dengan nilai seperti gemini-2-5-flash, selesai.

Mulai cepat

Anda tetap menggunakan SDK resmi OpenAI. Hanya ubah base_url dan nama model — jangan ubah yang lain:

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

Jaga keamanan kunci Anda

• Jangan pernah mengekspos kunci di sisi klien. Bundle browser dan mobile bersifat publik — selalu gunakan proxy melalui server Anda sendiri. Simpan kunci dalam file .env dan variabel lingkungan, jangan pernah menanamkannya dalam kode sumber.
• Gunakan kunci terpisah per project atau lingkungan agar kebocoran dapat dicabut tanpa menonaktifkan bagian lainnya.
• Lakukan rotasi secara berkala. Kunavo mengizinkan beberapa kunci aktif secara bersamaan; dengan demikian rotasi menjadi transisi tumpang tindih yang mulus, bukan pemutusan mendadak.
• Tetapkan batas pengeluaran per kunci. Tetapkan batas untuk setiap kunci melalui dashboard dan pantau lalu lintas tak terduga di halaman /app/usage, berdasarkan kunci.

FAQ