Untuk menggunakan Gemini API, Anda memerlukan kunci API. Anda dapat membuat kunci secara gratis dengan beberapa klik di Google AI Studio.
Setelah memiliki kunci API, Anda memiliki opsi berikut untuk terhubung ke Gemini API:
Untuk pengujian awal, Anda dapat melakukan hard code pada kunci API, tetapi ini hanya boleh bersifat sementara karena tidak aman. Anda dapat menemukan contoh untuk melakukan hard code pada kunci API di artikel Memberikan kunci API secara eksplisit.
Menetapkan kunci API sebagai variabel lingkungan
Jika Anda menetapkan variabel lingkungan GEMINI_API_KEY
atau GOOGLE_API_KEY
, kunci API akan otomatis diambil oleh klien saat menggunakan salah satu
library Gemini API. Sebaiknya Anda
hanya menetapkan salah satu variabel tersebut, tetapi jika keduanya ditetapkan, GOOGLE_API_KEY
akan
diprioritaskan.
Jika menggunakan REST API, atau JavaScript di browser, Anda harus memberikan kunci API secara eksplisit.
Berikut adalah cara menetapkan kunci API secara lokal sebagai variabel lingkungan GEMINI_API_KEY
dengan sistem operasi yang berbeda.
Linux/macOS - Bash
Bash adalah konfigurasi terminal Linux dan macOS yang umum. Anda dapat memeriksa apakah Anda memiliki file konfigurasi untuknya dengan menjalankan perintah berikut:
~/.bashrc
Jika responsnya adalah "Tidak ada file atau direktori tersebut", Anda harus membuat file ini
dan membukanya dengan menjalankan perintah berikut, atau menggunakan zsh
:
touch ~/.bashrc
open ~/.bashrc
Selanjutnya, Anda perlu menetapkan kunci API dengan menambahkan perintah ekspor berikut:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>
Setelah menyimpan file, terapkan perubahan dengan menjalankan:
source ~/.bashrc
macOS - Zsh
Zsh adalah konfigurasi terminal Linux dan macOS yang umum. Anda dapat memeriksa apakah Anda memiliki file konfigurasi untuknya dengan menjalankan perintah berikut:
~/.zshrc
Jika responsnya adalah "Tidak ada file atau direktori tersebut", Anda harus membuat file ini
dan membukanya dengan menjalankan perintah berikut, atau menggunakan bash
:
touch ~/.zshrc
open ~/.zshrc
Selanjutnya, Anda perlu menetapkan kunci API dengan menambahkan perintah ekspor berikut:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>
Setelah menyimpan file, terapkan perubahan dengan menjalankan:
source ~/.zshrc
Windows
- Telusuri "Variabel Lingkungan" di setelan sistem
- Edit "User variables" (untuk pengguna saat ini) atau "System variables" (untuk semua pengguna - gunakan dengan hati-hati).
- Buat variabel dan tambahkan
export GEMINI_API_KEY=your_key_here
- Menerapkan perubahan
Memberikan kunci API secara eksplisit
Dalam beberapa kasus, Anda mungkin ingin memberikan kunci API secara eksplisit. Contoh:
- Anda melakukan panggilan API sederhana dan lebih memilih hard code kunci API.
- Anda menginginkan kontrol eksplisit tanpa harus mengandalkan penemuan otomatis variabel lingkungan oleh library Gemini API
- Anda menggunakan lingkungan tempat variabel lingkungan tidak didukung (misalnya web) atau Anda melakukan panggilan REST.
Berikut adalah contoh cara memberikan kunci API secara eksplisit:
Python
from google import genai
client = genai.Client(api_key="YOUR_API_KEY")
response = client.models.generate_content(
model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });
async function main() {
const response = await ai.models.generateContent({
model: "gemini-2.5-flash",
contents: "Explain how AI works in a few words",
});
console.log(response.text);
}
main();
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
APIKey: "YOUR_API_KEY",
Backend: genai.BackendGeminiAPI,
})
if err != nil {
log.Fatal(err)
}
result, err := client.Models.GenerateContent(
ctx,
"gemini-2.5-flash",
genai.Text("Explain how AI works in a few words"),
nil,
)
if err != nil {
log.Fatal(err)
}
fmt.Println(result.Text())
}
Java
package com.example;
import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;
public class GenerateTextFromTextInput {
public static void main(String[] args) {
Client client = Client.builder().apiKey("YOUR_API_KEY").build();
GenerateContentResponse response =
client.models.generateContent(
"gemini-2.5-flash",
"Explain how AI works in a few words",
null);
System.out.println(response.text());
}
}
REST
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [
{
"parts": [
{
"text": "Explain how AI works in a few words"
}
]
}
]
}'
Menjaga kunci API Anda tetap aman
Anda harus menjaga keamanan kunci Gemini API Anda. Berikut beberapa hal yang perlu diingat saat menggunakan kunci Gemini API:
Google AI Gemini API menggunakan kunci API untuk otorisasi. Jika orang lain mendapatkan akses ke kunci Gemini API Anda, mereka dapat melakukan panggilan menggunakan kuota project Anda, yang dapat mengakibatkan hilangnya kuota atau tagihan tambahan untuk project yang ditagih, selain mengakses model dan file yang dioptimalkan.
Menambahkan pembatasan kunci API dapat membantu membatasi area permukaan yang dapat digunakan melalui setiap kunci API.
Anda bertanggung jawab untuk menjaga keamanan kunci Gemini API Anda.
- JANGAN periksa kunci Gemini API ke dalam kontrol sumber.
- Aplikasi sisi klien (web, dan Dart/Flutter) berisiko mengekspos kunci API. Sebaiknya jangan gunakan SDK klien Google AI di aplikasi produksi untuk memanggil Google AI Gemini API langsung dari aplikasi web Anda.
Untuk beberapa praktik terbaik umum, Anda juga dapat meninjau artikel dukungan ini.