Panduan memulai Gemini API

Panduan memulai ini menunjukkan cara menginstal library kami dan membuat permintaan Gemini API pertama Anda.

Sebelum memulai

Untuk menggunakan Gemini API, Anda harus memiliki kunci API untuk mengautentikasi permintaan, menerapkan batas keamanan, dan melacak penggunaan ke akun Anda.

Buat kunci API di AI Studio secara gratis untuk memulai:

Membuat Kunci Gemini API

Menginstal Google GenAI SDK

Python

Dengan Python 3.9+, instal paket google-genai menggunakan perintah pip berikut:

pip install -q -U google-genai

JavaScript

Dengan Node.js v18+, instal Google Gen AI SDK untuk TypeScript dan JavaScript menggunakan perintah npm berikut:

npm install @google/genai

Go

Instal google.golang.org/genai di direktori modul Anda menggunakan perintah go get:

go get google.golang.org/genai

Java

Jika menggunakan Maven, Anda dapat menginstal google-genai dengan menambahkan kode berikut ke dependensi Anda:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

Instal googleapis/go-genai di direktori modul Anda menggunakan perintah dotnet add

dotnet add package Google.GenAI

Apps Script

  1. Untuk membuat project Apps Script baru, buka script.new.
  2. Klik Project tanpa judul.
  3. Ganti nama project Apps Script menjadi AI Studio , lalu klik Ganti Nama.
  4. Tetapkan kunci API Anda
    1. Di sebelah kiri, klik Setelan Project Ikon untuk setelan project.
    2. Di bagian Properti Skrip , klik Tambahkan properti skrip.
    3. Untuk Properti, masukkan nama kunci: GEMINI_API_KEY.
    4. Untuk Nilai, masukkan nilai untuk kunci API.
    5. Klik Simpan properti skrip.
  5. Ganti konten file Code.gs dengan kode berikut:

Membuat permintaan pertama Anda

Ada dua cara yang dapat Anda gunakan untuk mengirim permintaan ke Gemini API:

  • (Direkomendasikan) Interactions API adalah primitif baru dengan dukungan native untuk penggunaan alat multi-langkah, orkestrasi, dan alur penalaran kompleks melalui langkah-langkah eksekusi yang diketik. Ke depannya, model baru di luar keluarga utama inti, beserta kemampuan dan alat agentik baru, akan diluncurkan secara eksklusif di Interactions API.
  • generateContent menyediakan cara untuk membuat respons sederhana dan tanpa status dari model. Meskipun kami merekomendasikan penggunaan Interactions API, generateContent didukung sepenuhnya.

Contoh ini menggunakan metode generateContentuntuk mengirim permintaan ke Gemini API menggunakan model Gemini 2.5 Flash.

Jika Anda menetapkan kunci API sebagai variabel lingkungan GEMINI_API_KEY, kunci tersebut akan otomatis diambil oleh klien saat menggunakan library Gemini API. Jika tidak, Anda harus meneruskan kunci API sebagai argumen saat melakukan inisialisasi klien.

Perhatikan bahwa semua contoh kode dalam dokumen Gemini API mengasumsikan bahwa Anda telah menetapkan variabel lingkungan GEMINI_API_KEY.

Python

from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

response = client.models.generate_content(
    model="gemini-3-flash-preview", contents="Explain how AI works in a few words"
)
print(response.text)

JavaScript

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

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    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()
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-3-flash-preview",
        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) {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    Client client = new Client();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-3-flash-preview",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

C#

using System.Threading.Tasks;
using Google.GenAI;
using Google.GenAI.Types;

public class GenerateContentSimpleText {
  public static async Task main() {
    // The client gets the API key from the environment variable `GOOGLE_API_KEY`.
    var client = new Client();
    var response = await client.Models.GenerateContentAsync(
      model: "gemini-3-flash-preview", contents: "Explain how AI works in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Parts[0].Text);
  }
}

Apps Script

// See https://developers.google.com/apps-script/guides/properties
// for instructions on how to set the API key.
const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
function main() {
  const payload = {
    contents: [
      {
        parts: [
          { text: 'Explain how AI works in a few words' },
        ],
      },
    ],
  };

  const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiKey,
    },
    payload: JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(url, options);
  const data = JSON.parse(response);
  const content = data['candidates'][0]['content']['parts'][0]['text'];
  console.log(content);
}

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Langkah berikutnya

Setelah membuat permintaan API pertama, Anda mungkin ingin menjelajahi panduan berikut yang menunjukkan Gemini beraksi: