Referensi Gemini API

Referensi API ini menjelaskan API unary, streaming, dan real-time yang dapat Anda gunakan untuk berinteraksi dengan model Gemini. Anda dapat menggunakan REST API di lingkungan mana pun yang mendukung permintaan HTTP. Lihat Panduan memulai untuk mengetahui cara memulai panggilan API pertama Anda. Jika Anda mencari referensi untuk library dan SDK khusus bahasa kami, buka link untuk bahasa tersebut di navigasi kiri di bagian Referensi SDK.

Endpoint utama

Gemini API disusun berdasarkan endpoint utama berikut:

• Interaksi (CreateInteraction) (Direkomendasikan): Primitif standar yang direkomendasikan untuk membangun dengan Gemini, dioptimalkan untuk alur kerja agen, pengelolaan status sisi server, dan percakapan multi-modal, multi-turn yang kompleks.
• Pembuatan konten standar (generateContent): Endpoint REST standar yang memproses permintaan Anda dan menampilkan respons lengkap model dalam satu paket. Hal ini paling baik untuk tugas non-interaktif yang dapat Anda tunggu hasilnya.
• Pembuatan konten streaming (streamGenerateContent): Menggunakan Server-Sent Events (SSE) untuk mengirimkan potongan respons kepada Anda saat respons tersebut dibuat. Hal ini memberikan pengalaman yang lebih cepat dan interaktif untuk aplikasi seperti chatbot.
• Live API (BidiGenerateContent): API berbasis WebSocket stateful untuk streaming dua arah, yang dirancang untuk kasus penggunaan percakapan real-time
• Mode batch (batchGenerateContent): Endpoint REST standar untuk mengirimkan batch permintaan generateContent.
• Embedding (embedContent): Endpoint REST standar yang menghasilkan vektor embedding teks dari Content input.
• Gen Media API: Endpoint untuk membuat media dengan model khusus kami seperti Imagen untuk pembuatan gambar, dan Veo untuk pembuatan video. Gemini juga memiliki kemampuan bawaan yang dapat Anda akses menggunakan generateContent API.
• Platform API: Endpoint utilitas yang mendukung kemampuan inti seperti mengupload file, dan menghitung token.

Autentikasi

Semua permintaan ke Gemini API harus menyertakan header x-goog-api-key dengan kunci API Anda. Buat kunci API dengan beberapa klik di Google AI Studio.

Berikut adalah contoh permintaan dengan kunci API yang disertakan di header:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash: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"
          }
        ]
      }
    ]
  }'

Untuk mengetahui petunjuk cara meneruskan kunci ke API menggunakan Gemini SDK, lihat panduan Menggunakan kunci Gemini API.