Panduan memulai Gemini API

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

Sebelum memulai

Anda memerlukan kunci Gemini API. Jika belum memilikinya, Anda dapat mendapatkannya secara gratis di Google AI Studio.

Menginstal Google GenAI SDK

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

pip install -q -U google-genai

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

npm install @google/genai

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

go get google.golang.org/genai
  1. Untuk membuat project Apps Script baru, buka script.new.
  2. Klik Project tanpa judul.
  3. Ganti nama project Apps Script 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 Script Properties, klik Add script property.
    3. Untuk Property, 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

Gunakan metode generateContent untuk mengirim permintaan ke Gemini API.

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.0-flash", contents="Explain how AI works in a few words"
)
print(response.text)
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.0-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();
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.0-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}
// 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-2.0-flash:generateContent?key=${apiKey}`;
  const options = {
    method: 'POST',
    contentType: 'application/json',
    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);
}
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-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"
          }
        ]
      }
    ]
  }'

Langkah berikutnya

Setelah membuat permintaan API pertama, Anda dapat mempelajari panduan berikut yang menunjukkan cara kerja Gemini: