Cara Mendapatkan Kunci API Google Gemini (2026): Buat, Uji, dan Amankan untuk Produksi

Cara Mendapatkan Kunci API Google Gemini (2026): Buat, Uji, dan Amankan untuk Produksi

Untuk mendapatkan kunci API Google Gemini, masuk ke Google AI Studio dengan akun Google, setujui persyaratannya, buka halaman Kunci API, lalu klik Buat kunci API; pengguna baru otomatis mendapatkan proyek Google Cloud dan kunci bawaan. Pembuatan kunci gratis, dan beberapa model Gemini, termasuk Gemini 3.8 Flash dan Gemini 3.5 Flash-Lite, menyediakan paket gratis. Sejak 28 Mei 2026, setiap kunci baru yang dibuat di AI Studio merupakan "kunci otorisasi" yang terikat pada akun layanan, dan Gemini API menolak kunci lama tanpa pembatasan. Jadi, kunci yang berfungsi tahun lalu mungkin perlu diganti (dokumentasi kunci API Google, diperiksa pada 27 Oktober 2026).

Panduan ini ditujukan bagi pengembang independen dan tim kecil yang ingin menyiapkan kunci Gemini dalam hitungan menit sekaligus memastikan keamanannya di produksi. Panduan ini membahas langkah penyiapan, jenis kunci baru, paket gratis, permintaan pertama dengan curl, Python, dan Node.js, error yang paling sering ditemui, serta daftar periksa untuk produksi. Jika Anda sedang membandingkan biaya, panduan harga Gemini API kami memuat daftar tarif lengkapnya.

Cara mendapatkan kunci Gemini API, langkah demi langkah

1. Buka Google AI Studio. Kunjungi aistudio.google.com/apikey dan masuk dengan akun Google yang akan digunakan untuk penagihan atau kepemilikan proyek.
2. Setujui persyaratannya. Jika Anda pengguna baru, AI Studio membuat proyek Google Cloud dan kunci API bawaan setelah Anda menyetujui Persyaratan Layanan. Nama proyek dapat diubah nanti di tampilan Proyek.
3. Pilih atau impor proyek. Jika Anda sudah menggunakan Google Cloud, AI Studio tidak membuat proyek bawaan. Buka Dasbor → Proyek → Impor proyek, lalu pilih proyek Cloud yang Anda inginkan.
4. Buat kunci. Di halaman Kunci API, klik Buat kunci API dan pilih proyeknya. Secara default, kunci baru berupa kunci otorisasi.
5. Salin sekali dan simpan. Segera simpan kunci dalam variabel lingkungan atau pengelola rahasia, bukan dalam berkas di repositori Anda.
6. Terapkan pembatasan. Jika kunci hanya akan digunakan untuk memanggil Gemini, batasi penggunaannya pada Gemini API (Generative Language API). Jika kunci akan digunakan dari server dengan IP tetap, tambahkan pembatasan IP di konsol Google Cloud.
7. Uji kunci dengan salah satu permintaan di bawah ini.

Langkah-langkah ini didasarkan pada Menggunakan kunci Gemini API, Google AI for Developers, terakhir diperbarui pada 27 Oktober 2026.

Di mana saya bisa menemukan kunci API Google saya nanti?

Di Google AI Studio, buka Dasbor → Kunci API. AI Studio menampilkan hingga 100 kunci dan 50 proyek, serta hanya mencantumkan kunci tanpa pembatasan atau kunci yang dibatasi pada Gemini API. Kunci yang dibatasi pada Google API lainnya hanya muncul di halaman kredensial konsol Google Cloud. Jika suatu proyek tidak muncul, impor terlebih dahulu.

Kunci standar vs kunci otorisasi: apa yang berubah pada 2026

Google sedang mengalihkan Gemini API dari kunci API standar ke kunci otorisasi (auth). Menurut dokumentasi resmi (27 Oktober 2026):

	Kunci API standar	Kunci otorisasi
Terikat pada	Proyek Google Cloud, untuk penagihan dan kuota	Akun layanan Google Cloud
Mengidentifikasi pemanggil	Tidak	Ya, permintaan dijalankan sebagai akun layanan yang terikat
Cakupan default	Bergantung pada pembatasan yang Anda tambahkan	Dibatasi pada Gemini API secara default
Penanganan kunci bocor	Manual	Penegakan cepat yang menghentikan penggunaan kunci bocor yang terdeteksi oleh Google
Dibuat oleh AI Studio	Sebelum 28 Mei 2026	Mulai 28 Mei 2026
Masih berfungsi?	Hanya jika memiliki pembatasan eksplisit	Ya

Dampaknya dalam praktik:

• Kunci standar tanpa pembatasan ditolak. Jika kunci lama tidak memiliki pembatasan API, permintaan Gemini akan gagal. Perbaiki di AI Studio: arahkan kursor ke label peringatan pada kunci, lalu pilih Batasi hanya ke Gemini API. Anda memerlukan izin apikeys.keys.update.
• Kunci tanpa pembatasan yang lama tidak digunakan diblokir. Sejak 7 Mei 2026, kunci tanpa pembatasan yang sudah lama tidak digunakan menampilkan label Diblokir. Buat kunci baru dan alihkan aplikasi Anda ke kunci tersebut.
• Awalan kunci baru. Para pengembang melaporkan bahwa kunci auth baru tidak lagi diawali dengan AIza yang sudah umum dikenal (contoh ulasan). Jika alat pihak ketiga memvalidasi kunci berdasarkan awalannya, alat tersebut mungkin menolak kunci baru yang valid. Perbarui alatnya alih-alih kembali menggunakan kunci standar.
• Izin untuk membuat kunci. Jika tombol Buat menyatakan bahwa Anda tidak memiliki izin, admin Cloud perlu memberi Anda peran yang mencakup apikeys.keys.create, serviceusage.services.enable, iam.serviceAccounts.create, dan iam.serviceAccountApiKeyBindings.create, beserta izin lainnya. Tanpa akses admin, Anda dapat membuat proyek baru yang tidak berada di bawah organisasi.

Tetapkan kunci sebagai variabel lingkungan

Library klien Google membaca GEMINI_API_KEY atau GOOGLE_API_KEY secara otomatis. Jika keduanya ditetapkan, GOOGLE_API_KEY yang diprioritaskan, dan ini sering menjadi penyebab "kunci baru saya tidak digunakan."

# macOS / Linux (add to ~/.zshrc or ~/.bashrc, then open a new terminal)
export GEMINI_API_KEY="paste-your-key-here"

# Make sure an old key is not overriding it
unset GOOGLE_API_KEY

Di Windows, tambahkan GEMINI_API_KEY melalui Properti Sistem → Variabel Lingkungan, lalu buka terminal baru.

Uji kunci Gemini API Anda

curl (Interactions API)

Panduan mulai cepat Google saat ini menggunakan endpoint Interactions dengan kunci di header x-goog-api-key:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Reply with the single word: ok"
  }'

Respons JSON yang berisi teks keluaran berarti kunci, proyek, dan akses model semuanya berfungsi. 403 biasanya berarti kunci dibatasi pada API lain atau diblokir; 429 berarti Anda mencapai batas laju (lihat di bawah).

Python (google-genai SDK)

# pip install google-genai
from google import genai

client = genai.Client()  # reads GEMINI_API_KEY from the environment

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain what an API key is in one sentence.",
)
print(interaction.output_text)

Node.js (@google/genai)

// npm install @google/genai
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain what an API key is in one sentence.",
});
console.log(interaction.output_text);

Gunakan kunci yang sama dengan OpenAI SDK

Gemini juga menyediakan endpoint yang kompatibel dengan OpenAI. Ini berguna untuk alat yang hanya menerima URL dasar OpenAI, seperti banyak agen pemrograman dan aplikasi chat:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GEMINI_API_KEY"],
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Say ok"}],
)
print(resp.choices[0].message.content)

Untuk penyiapan tiap alat melalui satu gateway, lihat Gemini API melalui router yang kompatibel dengan OpenAI.

Apakah kunci Gemini API gratis?

Kuncinya gratis, begitu pula paket gratis dengan penggunaan terbatas. Halaman harga Google (diperiksa pada 27 Oktober 2026) menjelaskan tiga paket: Free, Paid, dan Enterprise. Paket gratis menyediakan token masukan dan keluaran gratis untuk model tertentu, tetapi konten yang dikirim melalui paket gratis digunakan untuk meningkatkan produk Google. Pada paket berbayar, konten tidak digunakan untuk tujuan tersebut. Jangan kirim data pelanggan menggunakan kunci paket gratis.

Model	Paket gratis	Masukan / keluaran berbayar per 1M token (Standard)
Gemini 4 Argon	Tidak tersedia	$2.00 / $10.00 hingga 30 November 2026; $4.00 / $20.00 mulai 1 Desember 2026
Gemini 3.8 Flash	Ya	$0.75 / $3.75 hingga 31 Desember 2026; $1.50 / $7.50 mulai 1 Januari 2027
Gemini 3.5 Flash-Lite	Ya	$0.30 / $2.50
Gemini 3.1 Flash-Lite	Ya	$0.25 / $1.50 (teks, gambar, video)

Sumber: Harga Gemini Developer API, 27 Oktober 2026. Perhatikan kenaikan harga yang sudah dijadwalkan: anggarkan tarif yang lebih tinggi jika aplikasi Anda akan tetap berjalan setelah tanggal-tanggal tersebut.

Cara menggunakan Gemini API secara gratis

1. Buat kunci di AI Studio tanpa menghubungkan penagihan. Proyek akan tetap berada di paket Free.
2. Gunakan model yang menyediakan paket gratis, seperti gemini-3.8-flash atau gemini-3.5-flash-lite. Gemini 4 Argon hanya tersedia berbayar.
3. Jaga penggunaan agar tetap dalam batas laju paket gratis yang ditampilkan di AI Studio. Batas berlaku per proyek, bukan per kunci, sehingga membuat lebih banyak kunci dalam satu proyek tidak menambah kuota.
4. Gunakan hanya data pengujian atau data publik, karena konten pada paket gratis dapat digunakan untuk meningkatkan produk Google.

Batas laju dan tingkatan penggunaan

Batas laju Gemini diukur dalam permintaan per menit (RPM), token masukan per menit (TPM), dan permintaan per hari (RPD). Melampaui salah satunya akan menghasilkan error, dan RPD direset pada tengah malam waktu Pasifik (batas laju, 27 Oktober 2026). Google juga menerapkan batas berdasarkan pengeluaran dalam jendela bergulir 10 menit, yang menghasilkan 429 RESOURCE_EXHAUSTED.

Tingkatan	Syarat	Batas penagihan per tingkatan
Free	Proyek aktif atau uji coba gratis	Tidak berlaku
Tingkat 1	Hubungkan akun penagihan aktif	$250
Tingkat 2	Telah membayar $100 + 3 hari sejak pembayaran pertama yang berhasil	$2,000
Tingkat 3	Telah membayar $1,000 + 30 hari sejak pembayaran pertama yang berhasil	$20,000 hingga $100,000+

Sumber: Batas laju Gemini API, 27 Oktober 2026. Periksa batas pasti untuk tiap model di AI Studio; Google menyatakan bahwa batas yang tercantum tidak dijamin.

Apa yang bisa dilakukan orang lain dengan kunci API Anda?

Siapa pun yang memiliki kunci Gemini Anda dapat mengirim permintaan yang ditagihkan ke proyek Anda dan menghabiskan kuota Anda. Dokumentasi Google memperingatkan bahwa kunci yang bocor dapat menyebabkan "biaya tagihan tak terduga" dan akses ke data pribadi dalam proyek. Dengan kunci otorisasi, penyerang bertindak sebagai akun layanan yang terikat dan dapat mengakses apa pun yang dapat diakses akun tersebut (praktik terbaik kunci API Google Cloud). Karena itu, batasi izin akun layanan seminimal mungkin.

Jika Anda menduga kunci bocor:

1. Buat kunci pengganti di AI Studio.
2. Terapkan kunci baru ke aplikasi Anda dan pastikan kunci tersebut berfungsi.
3. Nonaktifkan kunci lama di konsol Cloud. Jangan menghapusnya sebelum kunci baru aktif, karena hal itu akan menyebabkan gangguan layanan.
4. Periksa penagihan dan penggunaan API di konsol Cloud untuk menemukan trafik yang tidak dikenal. Halaman Penggunaan AI Studio mengelompokkan trafik yang tidak dapat dicocokkan dengan kunci bernama sebagai "(kunci tidak dikenal)."

Pemecahan masalah: mengapa kunci Gemini API Anda tidak berfungsi

Gejala	Kemungkinan penyebab	Solusi
403 atau "Kunci API tidak valid" pada kunci lama	Kunci standar tanpa pembatasan, kini ditolak	Batasi hanya ke Gemini API, atau buat kunci auth baru
Kunci menampilkan Diblokir di AI Studio	Kunci tanpa pembatasan yang lama tidak digunakan, diblokir sejak 7 Mei 2026	Buat kunci baru dan perbarui aplikasi Anda
Kunci baru diabaikan oleh kode Anda	GOOGLE_API_KEY juga ditetapkan dan diprioritaskan	Hapus pengaturan variabel tersebut atau tetapkan nilainya ke kunci baru
Alat pihak ketiga menyatakan format kunci salah	Alat mengharapkan awalan lama	Perbarui alat, atau arahkan permintaan melalui gateway yang kompatibel dengan OpenAI
"Anda tidak memiliki izin untuk membuat kunci"	Izin IAM yang diperlukan tidak tersedia di proyek Cloud	Minta bantuan admin, atau gunakan proyek di luar organisasi
429 RESOURCE_EXHAUSTED	Batas RPM, TPM, RPD, atau batas berdasarkan pengeluaran	Coba lagi dengan backoff, kurangi ukuran permintaan, atau naik ke tingkatan yang lebih tinggi
Model tidak ditemukan atau tidak tersedia	Model tidak termasuk paket gratis (misalnya Gemini 4 Argon)	Hubungkan penagihan atau pilih model paket gratis

Untuk pola penanganan error lintas penyedia, lihat taksonomi error gateway LLM kami.

Daftar periksa kunci Gemini API untuk produksi

Kunci yang berfungsi di notebook belum tentu siap digunakan oleh pengguna. Sebelum peluncuran:

• Simpan kunci di server. Jangan pernah menyertakannya dalam aplikasi web atau seluler; Google menyatakan bahwa kunci dalam kode klien dapat diekstrak. Tempatkan proxy backend kecil di antara klien Anda dan Gemini.
• Gunakan satu kunci per lingkungan dan per aplikasi. Pisahkan kunci pengembangan, staging, dan produksi agar Anda dapat mencabut satu kunci tanpa mengganggu yang lain. Beri nama yang jelas.
• Simpan di pengelola rahasia. Google merekomendasikan Secret Manager untuk produksi. Muat kunci saat aplikasi berjalan.
• Batasi berdasarkan API dan, jika memungkinkan, IP. Kunci auth secara default hanya dapat digunakan untuk Gemini; tambahkan pembatasan IP untuk backend dengan IP tetap.
• Minimalkan izin akun layanan. Jangan beri akun layanan yang terikat peran luas yang tidak dibutuhkannya.
• Aktifkan peringatan penagihan di konsol Google Cloud agar Anda mengetahui lonjakan penggunaan sebelum tagihan datang.
• Tetapkan ID model secara spesifik. Gunakan ID persis seperti gemini-3.8-flash dalam konfigurasi, dan rencanakan penyesuaian untuk perubahan harga pada 1 Desember 2026 dan 1 Januari 2027.
• Gunakan paket berbayar untuk data pengguna. Konten pada paket gratis dapat digunakan untuk meningkatkan produk Google.
• Rencanakan penanganan batas laju. Tambahkan exponential backoff untuk 429, dan tentukan tindakan saat batas tercapai: antrekan permintaan, beralih ke model yang lebih kecil, atau lakukan failover.
• Pindai repositori untuk mendeteksi kunci bocor. Aktifkan pemindaian rahasia GitHub dan perlindungan push.
• Rotasi kunci secara terjadwal. Buat kunci baru, terapkan, verifikasi, lalu nonaktifkan kunci lama.

Untuk peninjauan lebih mendalam, gunakan daftar periksa kesiapan produksi Gemini API dan panduan pengelolaan kunci API yang aman kami.

Kapan satu kunci Flatkey lebih praktis daripada kunci Gemini

Jika aplikasi Anda juga memanggil Claude, GPT, DeepSeek, atau Qwen, mengelola kunci, akun penagihan, dan tingkatan batas laju terpisah untuk tiap penyedia akan menambah pekerjaan. Flatkey menyediakan satu kunci dan URL dasar yang kompatibel dengan OpenAI (https://router.flatkey.ai/v1) untuk Gemini dan model lainnya, dengan log penggunaan per kunci (dokumentasi Flatkey). Pertimbangkan selisih harganya secara terbuka, karena berbeda untuk tiap model. Pada 27 Oktober 2026, halaman model Flatkey mencantumkan:

Model	Harga resmi Google (Standard)	Flatkey
Gemini 4 Argon	$2.00 / $10.00	$1.60 / $8.00
Gemini 3.5 Flash-Lite	$0.30 / $2.50	$0.24 / $2.00
Gemini 3.8 Flash	$0.75 / $3.75 (promo hingga 31 Desember 2026)	$1.20 / $6.00

Untuk Gemini 3.8 Flash, harga promosi Google lebih rendah daripada Flatkey hingga 31 Desember 2026, sehingga aplikasi yang hanya menggunakan Flash lebih hemat jika memanggil Google secara langsung sampai tanggal tersebut. Flatkey lebih masuk akal untuk Argon, Flash-Lite, atau aplikasi yang menggunakan beberapa penyedia.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["FLATKEY_API_KEY"], base_url="https://router.flatkey.ai/v1")
resp = client.chat.completions.create(
    model="gemini-4-argon",
    messages=[{"role": "user", "content": "Summarize this stack trace in one line."}],
)
print(resp.choices[0].message.content)

Tanya jawab

Bagaimana cara mendapatkan kunci API Google Gemini?

Masuk ke aistudio.google.com/apikey, setujui persyaratannya, pilih atau impor proyek Google Cloud, lalu klik Buat kunci API. Pengguna baru otomatis mendapatkan proyek dan kunci bawaan. Kunci ditampilkan di halaman Kunci API AI Studio.

Apakah kunci Gemini API gratis?

Ya. Pembuatan kunci tidak dikenakan biaya, dan model seperti Gemini 3.8 Flash dan Gemini 3.5 Flash-Lite menyediakan paket gratis dengan batas laju. Konten pada paket gratis dapat digunakan untuk meningkatkan produk Google, dan Gemini 4 Argon tidak tersedia secara gratis.

Bagaimana cara menggunakan Gemini API secara gratis?

Buat kunci tanpa menghubungkan penagihan, panggil model paket gratis seperti gemini-3.8-flash, dan jaga penggunaan agar tetap dalam batas yang ditampilkan di AI Studio. Batas berlaku per proyek, sehingga kunci tambahan dalam proyek yang sama tidak menambah kuota.

Di mana saya bisa menemukan kunci API Google saya?

Di Google AI Studio melalui Dasbor → Kunci API. Kunci yang dibatasi pada Google API selain Gemini hanya tercantum di halaman kredensial konsol Google Cloud.

Apa yang bisa dilakukan orang lain dengan kunci API saya?

Mereka dapat mengirim permintaan yang ditagihkan ke proyek Anda, menghabiskan kuota Anda, dan, dengan kunci otorisasi, bertindak sebagai akun layanan yang terikat. Ganti kunci, terapkan kunci baru, nonaktifkan kunci lama, dan tinjau penggunaan jika Anda menduga terjadi kebocoran.

Mengapa kunci Gemini API lama saya berhenti berfungsi?

Sejak 2026, Gemini API menolak kunci standar tanpa pembatasan, dan sejak 7 Mei 2026, API ini memblokir kunci tanpa pembatasan yang sudah lama tidak digunakan. Batasi kunci pada Gemini API atau buat kunci otorisasi baru.

Bisakah saya menggunakan kunci Gemini API dengan OpenAI SDK?

Ya. Tetapkan URL dasar ke https://generativelanguage.googleapis.com/v1beta/openai/ dan berikan kunci Gemini Anda sebagai kunci API.

Kesimpulan

Mendapatkan kunci Gemini hanya memerlukan dua menit di AI Studio; menjaga keamanannya membutuhkan sedikit upaya tambahan. Gunakan kunci otorisasi, simpan di server dalam pengelola rahasia, terapkan pembatasan, atur peringatan penagihan, gunakan paket berbayar untuk data pengguna nyata, dan pantau perubahan harga yang sudah dijadwalkan. Jika Anda menggunakan beberapa penyedia, satu kunci gateway dapat menggantikan kumpulan kunci dari tiap penyedia. Bandingkan model di katalog model Flatkey dan lihat panduan perutean Gemini vs Claude untuk menentukan kapan trafik sebaiknya diarahkan ke masing-masing model.