Dokumentasi
API key Gemini
Cara mendapatkan API key Gemini dan memanggil model Gemini Pro dan Flash melalui endpoint yang kompatibel dengan OpenAI — jalur langsung Google AI Studio serta jalur satu key Kunavo yang juga mengakses Claude, GPT-Image, Veo, dan Suno.
API key Gemini mengautentikasi panggilan Anda ke model Gemini milik Google. Anda bisa mendapatkannya langsung dari Google AI Studio, atau menggunakan satu key sk-kn- untuk mengakses Gemini melalui API kompatibel OpenAI yang sama dengan yang sudah Anda gunakan untuk semua hal lainnya.
/app/keys, atur base_url=https://api.kunavo.com/v1, lalu panggil model="gemini-2-5-flash". Tidak perlu project Google Cloud, dan key yang sama juga berfungsi untuk Claude, GPT-Image, dan Veo.Apa itu API key Gemini
API key Gemini adalah kredensial bearer yang mengizinkan permintaan ke keluarga Gemini milik Google. Setiap permintaan menyertakan key di header Authorization; platform menghitung penggunaan berdasarkan key tersebut dan menagih per token. Saat ini, di Kunavo, hal itu berarti gemini-3-1-pro dan gemini-2-5-flash, yang dipanggil melalui endpoint kompatibel OpenAI.
Ada dua cara untuk mendapatkan key yang berfungsi, bergantung pada apakah Anda hanya ingin menggunakan Gemini atau juga model frontier lainnya.
Opsi A — key langsung dari Google AI Studio
- Buka
aistudio.google.comdan masuk dengan akun Google. - Buka Dapatkan API key → Buat API key. Bentuk key seperti
AIza.... - Untuk volume produksi, tautkan key ke project Google Cloud yang penagihannya telah diaktifkan.
Ini pilihan yang tepat jika Anda hanya akan menggunakan Gemini. Jika Anda juga menggunakan Claude, model gambar, atau video, Anda perlu mengelola key, SDK, dan tagihan terpisah untuk setiap penyedia.
Opsi B — satu Kunavo key untuk Gemini dan semuanya
Kunavo adalah gateway API AI independen yang kompatibel dengan OpenAI: satu kunci API dan satu saldo bayar sesuai pemakaian memungkinkan Anda mengakses model Claude, GPT, serta model gambar, video, dan audio, tanpa memerlukan akun terpisah untuk setiap penyedia.
Kunavo menyediakan Gemini melalui API yang kompatibel dengan OpenAI. Satu key sk-kn- dapat mengakses Gemini dan semua model lainnya, dengan satu saldo yang ditagihkan melalui Stripe.
| Key Google AI Studio | Kunci Kunavo | |
|---|---|---|
| Model | Gemini saja | Gemini + Claude, GPT-Image, Veo, Suno |
| Endpoint | Google GenAI API | https://api. |
| Penagihan | Akun Google Cloud | Satu dompet Stripe |
| Minimum untuk memulai | Tier gratis (dibatasi laju) | Pengisian saldo $10, tanpa kedaluwarsa |
| Format kunci | AIza... | sk-kn-... |
- Buat akun Kunavo dan tambahkan pengisian saldo sebesar $10 — bayar sesuai penggunaan, saldo tidak pernah kedaluwarsa.
- Buat key di
/app/keys. Key hanya ditampilkan sekali; simpan di variabel lingkungan. - Arahkan OpenAI SDK ke
https://api.kunavo.com/v1dan panggil slug Gemini.
Memanggil Gemini dengan Python
Tetap gunakan OpenAI SDK resmi. Ubah 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", # the only line that changes
)
resp = client.chat.completions.create(
model="gemini-2-5-flash",
messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)Memanggil Gemini dengan Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "gemini-2-5-flash",
messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);baseURL di Node dan base_url di Python. Keduanya mengarah ke endpoint yang sama.Atau panggil dengan curl
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2-5-flash",
"messages": [{"role": "user", "content": "Hello, Gemini"}]
}'Memilih model Gemini
- gemini-2-5-flash — pilihan bawaan yang cepat dan sangat murah untuk chat, ekstraksi, dan peringkasan.
- gemini-3-1-pro — penalaran, visi, dan analisis konteks panjang yang lebih kuat.
Daftar periksa keamanan
- Jangan pernah mengekspos key di sisi klien. Bundel browser dan seluler bersifat publik — selalu gunakan server Anda sendiri sebagai perantara.
- Gunakan satu key untuk setiap project atau lingkungan agar kebocoran dapat ditangani dengan mencabut key tersebut tanpa mengganggu yang lainnya.
- Lakukan rotasi setiap tiga bulan. Kunavo mengizinkan beberapa key aktif, sehingga rotasi bisa dilakukan dengan masa tumpang tindih yang mulus, tanpa perpindahan mendadak.
- Pantau
/app/usageuntuk melihat trafik tak terduga yang dirinci berdasarkan key.
Pertanyaan umum
Apakah API key Gemini gratis?
Google AI Studio menerbitkan key untuk tier gratis dengan batas laju yang rendah, cocok untuk membuat prototipe. Untuk trafik produksi, gunakan penagihan berbayar. Di Kunavo, Anda membayar sesuai penggunaan mulai dari pengisian saldo minimum $10 tanpa perlu akun penagihan Google Cloud terpisah — dan saldo Anda tidak pernah kedaluwarsa.
Bisakah saya menggunakan Gemini dengan OpenAI SDK?
Ya. Kunavo menyediakan Gemini melalui endpoint /v1/chat/completions yang kompatibel dengan OpenAI, sehingga Anda tetap menggunakan OpenAI SDK resmi dan hanya mengubah base_url menjadi https://api.kunavo.com/v1 serta mengatur nama model ke slug Gemini seperti gemini-2-5-flash.
Apa perbedaan antara API key Google Gemini dan API key Kunavo?
Google key hanya memanggil Gemini dan ditagihkan melalui akun Google Cloud. Kunavo key memanggil Gemini, Claude, GPT-Image, Veo, dan Suno melalui satu API yang kompatibel dengan OpenAI, dengan satu penagihan melalui Stripe.
Model Gemini mana yang sebaiknya saya gunakan terlebih dahulu?
Mulailah dengan gemini-2-5-flash untuk chat sehari-hari, ekstraksi, dan peringkasan — model ini cepat dan sangat murah. Beralihlah ke gemini-3-1-pro untuk penalaran yang lebih sulit, visi, dan analisis konteks panjang.