Panduan memulai Gemini API

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

Sebelum memulai

Penggunaan Gemini API memerlukan kunci API. Anda dapat membuatnya secara gratis untuk memulai.

Membuat Kunci Gemini API

Menginstal Google GenAI SDK

Python

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

pip install -q -U google-genai

JavaScript

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

npm install @google/genai

Membuat permintaan pertama Anda

Berikut adalah contoh yang menggunakan Interactions API untuk mengirim permintaan ke Gemini API menggunakan model Gemini 3 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()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.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 interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "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: