Dokumentasi

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.

Singkatnya — Daftar, buat key di /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

  1. Buka aistudio.google.com dan masuk dengan akun Google.
  2. Buka Dapatkan API key → Buat API key. Bentuk key seperti AIza....
  3. 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 StudioKunci Kunavo
ModelGemini sajaGemini + Claude, GPT-Image, Veo, Suno
EndpointGoogle GenAI APIhttps://api.kunavo.com/v1
PenagihanAkun Google CloudSatu dompet Stripe
Minimum untuk memulaiTier gratis (dibatasi laju)Pengisian saldo $10, tanpa kedaluwarsa
Format kunciAIza...sk-kn-...
  1. Buat akun Kunavo dan tambahkan pengisian saldo sebesar $10 — bayar sesuai penggunaan, saldo tidak pernah kedaluwarsa.
  2. Buat key di /app/keys. Key hanya ditampilkan sekali; simpan di variabel lingkungan.
  3. Arahkan OpenAI SDK ke https://api.kunavo.com/v1 dan 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);
OpenAI SDK menggunakan 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.
Untuk tarif per model dan contoh perhitungan biaya, lihat panduan harga API Gemini dan halaman harga.

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/usage untuk 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.

Langkah selanjutnya