Menggunakan kunci Gemini API

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

  1. Telusuri "Variabel Lingkungan" di setelan sistem
  2. Edit "User variables" (untuk pengguna saat ini) atau "System variables" (untuk semua pengguna - gunakan dengan hati-hati).
  3. Buat variabel dan tambahkan export GEMINI_API_KEY=your_key_here
  4. 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.