Gemini API

Gemini Interactions API adalah API eksperimental yang memungkinkan developer membuat aplikasi AI generatif menggunakan model Gemini. Gemini adalah model kami yang paling andal, yang dibuat dari awal agar multimodal. Model ini dapat melakukan generalisasi dan dengan lancar memahami, beroperasi, dan menggabungkan berbagai jenis informasi, termasuk bahasa, gambar, audio, video, dan kode. Anda dapat menggunakan Gemini API untuk kasus penggunaan seperti penalaran di seluruh teks dan gambar, pembuatan konten, agen dialog, sistem ringkasan dan klasifikasi, dan banyak lagi.

Lihat sebagai markdown Lihat Spesifikasi OpenAPI

Membuat interaksi

post https://generativelanguage.googleapis.com/v1beta/interactions

Membuat interaksi baru.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

model ModelOption  (opsional)

Nama `Model` yang digunakan untuk membuat interaksi.
Wajib diisi jika `agent` tidak diberikan.

Nilai yang mungkin:

  • gemini-2.5-flash

    Model penalaran hybrid pertama kami yang mendukung jendela konteks 1 juta token dan memiliki anggaran pemikiran.

  • gemini-2.5-flash-image

    Model pembuatan gambar native kami, yang dioptimalkan untuk kecepatan, fleksibilitas, dan pemahaman kontekstual. Input dan output teks dihargai sama dengan 2.5 Flash.

  • gemini-2.5-flash-lite

    Model terkecil dan paling hemat biaya kami, yang dibuat untuk penggunaan dalam skala besar.

  • gemini-2.5-flash-lite-preview-09-2025

    Model terbaru berdasarkan Gemini 2.5 Flash lite yang dioptimalkan untuk efisiensi biaya, throughput tinggi, dan kualitas tinggi.

  • gemini-2.5-flash-native-audio-preview-12-2025

    Model audio native kami dioptimalkan untuk output audio berkualitas lebih tinggi dengan pengaturan tempo, kealamian suara, kejelasan, dan suasana yang lebih baik.

  • gemini-2.5-flash-preview-09-2025

    Model terbaru berdasarkan model 2.5 Flash. Pratinjau 2.5 Flash paling cocok untuk pemrosesan skala besar, tugas latensi rendah dan volume tinggi yang memerlukan penalaran, serta kasus penggunaan agentik.

  • gemini-2.5-flash-preview-tts

    Model text-to-speech 2.5 Flash kami dioptimalkan untuk pembuatan ucapan yang canggih, mudah dikontrol, dan latensi rendah.

  • gemini-2.5-pro

    Model serbaguna canggih kami, yang unggul dalam tugas coding dan penalaran yang kompleks.

  • gemini-2.5-pro-preview-tts

    Model audio text-to-speech 2.5 Pro kami dioptimalkan untuk menghasilkan ucapan yang canggih dan latensi rendah untuk output yang lebih alami dan perintah yang lebih mudah diarahkan.

  • gemini-3-flash-preview

    Model kami yang paling cerdas, dibuat untuk kecepatan, menggabungkan kecerdasan terdepan dengan penelusuran dan perujukan yang unggul.

  • gemini-3-pro-image-preview

    Model pengeditan dan pembuatan gambar tercanggih.

  • gemini-3-pro-preview

    Model tercerdas kami dengan penalaran dan pemahaman multimodal SOTA, serta kemampuan agentic dan vibe coding yang canggih.

  • gemini-3.1-pro-preview

    Model penalaran SOTA terbaru kami dengan kedalaman dan nuansa yang belum pernah ada sebelumnya, serta kemampuan coding dan pemahaman multimodal yang canggih.

  • gemini-3.1-flash-image-preview

    Inteligensi visual tingkat profesional dengan efisiensi secepat kilat dan kemampuan pembuatan yang berbasis realitas.

Model yang akan menyelesaikan perintah Anda.\n\nLihat [model](https://ai.google.dev/gemini-api/docs/models) untuk mengetahui detail tambahan.

agent AgentOption  (opsional)

Nama `Agent` yang digunakan untuk membuat interaksi.
Wajib diisi jika `model` tidak diberikan.

Nilai yang mungkin:

  • deep-research-pro-preview-12-2025

    Agen Deep Research Gemini

Agen yang akan berinteraksi.

input Content atau array (Content) atau array (Turn) atau string  (wajib)

Input untuk interaksi (umum untuk Model dan Agen).

system_instruction string  (opsional)

Petunjuk sistem untuk interaksi.

tools array (Tool)  (opsional)

Daftar deklarasi alat yang dapat dipanggil model selama interaksi.

response_format object  (opsional)

Memastikan bahwa respons yang dihasilkan adalah objek JSON yang sesuai dengan skema JSON yang ditentukan dalam kolom ini.

response_mime_type string  (opsional)

Jenis MIME respons. Parameter ini diperlukan jika response_format ditetapkan.

stream boolean  (opsional)

Hanya input. Apakah interaksi akan di-streaming.

store boolean  (opsional)

Hanya input. Apakah akan menyimpan respons dan permintaan untuk pengambilan nanti.

background boolean  (opsional)

Hanya input. Apakah akan menjalankan interaksi model di latar belakang.

generation_config GenerationConfig  (opsional)

Konfigurasi Model
Parameter konfigurasi untuk interaksi model.
Alternatif untuk `agent_config`. Hanya berlaku jika `model` ditetapkan.

Parameter konfigurasi untuk interaksi model.

Kolom

temperature number  (opsional)

Mengontrol keacakan output.

top_p number  (opsional)

Probabilitas kumulatif maksimum token yang akan dipertimbangkan saat melakukan pengambilan sampel.

seed integer  (opsional)

Seed yang digunakan dalam decoding untuk kemampuan reproduksi.

stop_sequences array (string)  (opsional)

Daftar urutan karakter yang akan menghentikan interaksi output.

thinking_level ThinkingLevel  (opsional)

Tingkat token pemikiran yang harus dihasilkan model.

Nilai yang mungkin:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (opsional)

Apakah akan menyertakan ringkasan pemikiran dalam respons.

Nilai yang mungkin:

  • auto
  • none

max_output_tokens integer  (opsional)

Jumlah maksimum token yang akan disertakan dalam respons.

speech_config SpeechConfig  (opsional)

Konfigurasi untuk interaksi ucapan.

Konfigurasi untuk interaksi ucapan.

Kolom

voice string  (opsional)

Suara pembicara.

language string  (opsional)

Bahasa ucapan.

speaker string  (opsional)

Nama pembicara, harus cocok dengan nama pembicara yang diberikan dalam perintah.

image_config ImageConfig  (opsional)

Konfigurasi untuk interaksi gambar.

Konfigurasi untuk interaksi gambar.

Kolom

aspect_ratio enum (string)  (opsional)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (opsional)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig atau ToolChoiceType  (opsional)

Pilihan alat untuk interaksi.

agent_config object  (opsional)

Konfigurasi Agen
Konfigurasi untuk agen.
Alternatif untuk `generation_config`. Hanya berlaku jika `agent` ditetapkan.

Kemungkinan Jenis

Diskriminator polimorfik: type

DynamicAgentConfig

Konfigurasi untuk agen dinamis.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "dynamic".

DeepResearchAgentConfig

Konfigurasi untuk agen Deep Research.

thinking_summaries ThinkingSummaries  (opsional)

Apakah akan menyertakan ringkasan pemikiran dalam respons.

Nilai yang mungkin:

  • auto
  • none

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "deep-research".

previous_interaction_id string  (opsional)

ID interaksi sebelumnya, jika ada.

response_modalities ResponseModality  (opsional)

Modalitas respons yang diminta (TEKS, GAMBAR, AUDIO).

Nilai yang mungkin:

  • text
  • image
  • audio

Respons

Menampilkan resource Interaction.

Permintaan Sederhana

Contoh Respons

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

Multi-turn

Contoh Respons

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

Input Gambar

Contoh Respons

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

Pemanggilan Fungsi

Contoh Respons

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "id": "gth23981",
      "name": "get_weather",
      "arguments": {
        "location": "Boston, MA"
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_thought_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

Contoh Respons

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "agent",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_thought_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

Mengambil interaksi

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

Mengambil detail lengkap satu interaksi berdasarkan `Interaction.id`.

Parameter Jalur / Kueri

id string  (wajib)

ID unik interaksi yang akan diambil.

stream boolean  (opsional)

Jika disetel ke benar (true), konten yang dihasilkan akan di-streaming secara bertahap.

Default: False

last_event_id string  (opsional)

Opsional. Jika disetel, melanjutkan aliran interaksi dari potongan berikutnya setelah peristiwa yang ditandai oleh ID peristiwa. Hanya dapat digunakan jika `stream` benar.

include_input boolean  (opsional)

Jika disetel ke benar (true), menyertakan input dalam respons.

Default: False

api_version string  (opsional)

Versi API yang akan digunakan.

Respons

Menampilkan resource Interaction.

Mendapatkan Interaksi

Contoh Respons

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

Menghapus interaksi

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

Menghapus interaksi menurut ID.

Parameter Jalur / Kueri

id string  (wajib)

ID unik interaksi yang akan dihapus.

api_version string  (opsional)

Versi API yang akan digunakan.

Respons

Jika berhasil, responsnya akan kosong.

Menghapus Interaksi

Membatalkan interaksi

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

Membatalkan interaksi berdasarkan ID. Hal ini hanya berlaku untuk interaksi latar belakang yang masih berjalan.

Parameter Jalur / Kueri

id string  (wajib)

ID unik interaksi yang akan dibatalkan.

api_version string  (opsional)

Versi API yang akan digunakan.

Respons

Menampilkan resource Interaction.

Membatalkan Interaksi

Contoh Respons

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "agent"
}

Resource

Interaksi

Resource Interaksi.

Kolom

model ModelOption  (opsional)

Nama `Model` yang digunakan untuk membuat interaksi.

Nilai yang mungkin:

  • gemini-2.5-flash

    Model penalaran hybrid pertama kami yang mendukung jendela konteks 1 juta token dan memiliki anggaran pemikiran.

  • gemini-2.5-flash-image

    Model pembuatan gambar native kami, yang dioptimalkan untuk kecepatan, fleksibilitas, dan pemahaman kontekstual. Input dan output teks dihargai sama dengan 2.5 Flash.

  • gemini-2.5-flash-lite

    Model terkecil dan paling hemat biaya kami, yang dibuat untuk penggunaan dalam skala besar.

  • gemini-2.5-flash-lite-preview-09-2025

    Model terbaru berdasarkan Gemini 2.5 Flash lite yang dioptimalkan untuk efisiensi biaya, throughput tinggi, dan kualitas tinggi.

  • gemini-2.5-flash-native-audio-preview-12-2025

    Model audio native kami dioptimalkan untuk output audio berkualitas lebih tinggi dengan pengaturan tempo, kealamian suara, kejelasan, dan suasana yang lebih baik.

  • gemini-2.5-flash-preview-09-2025

    Model terbaru berdasarkan model 2.5 Flash. Pratinjau 2.5 Flash paling cocok untuk pemrosesan skala besar, tugas latensi rendah dan volume tinggi yang memerlukan penalaran, serta kasus penggunaan agentik.

  • gemini-2.5-flash-preview-tts

    Model text-to-speech 2.5 Flash kami dioptimalkan untuk pembuatan ucapan yang canggih, mudah dikontrol, dan latensi rendah.

  • gemini-2.5-pro

    Model serbaguna canggih kami, yang unggul dalam tugas coding dan penalaran yang kompleks.

  • gemini-2.5-pro-preview-tts

    Model audio text-to-speech 2.5 Pro kami dioptimalkan untuk menghasilkan ucapan yang canggih dan latensi rendah untuk output yang lebih alami dan perintah yang lebih mudah diarahkan.

  • gemini-3-flash-preview

    Model kami yang paling cerdas, dibuat untuk kecepatan, menggabungkan kecerdasan terdepan dengan penelusuran dan perujukan yang unggul.

  • gemini-3-pro-image-preview

    Model pengeditan dan pembuatan gambar tercanggih.

  • gemini-3-pro-preview

    Model tercerdas kami dengan penalaran dan pemahaman multimodal SOTA, serta kemampuan agentic dan vibe coding yang canggih.

  • gemini-3.1-pro-preview

    Model penalaran SOTA terbaru kami dengan kedalaman dan nuansa yang belum pernah ada sebelumnya, serta kemampuan coding dan pemahaman multimodal yang canggih.

  • gemini-3.1-flash-image-preview

    Inteligensi visual tingkat profesional dengan efisiensi secepat kilat dan kemampuan pembuatan yang berbasis realitas.

Model yang akan menyelesaikan perintah Anda.\n\nLihat [model](https://ai.google.dev/gemini-api/docs/models) untuk mengetahui detail tambahan.

agent AgentOption  (opsional)

Nama `Agent` yang digunakan untuk membuat interaksi.

Nilai yang mungkin:

  • deep-research-pro-preview-12-2025

    Agen Deep Research Gemini

Agen yang akan berinteraksi.

id string  (opsional)

Hanya output. ID unik untuk penyelesaian interaksi.

status enum (string)  (opsional)

Hanya output. Status interaksi.

Nilai yang mungkin:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (opsional)

Hanya output. Waktu saat respons dibuat dalam format ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

updated string  (opsional)

Hanya output. Waktu saat respons terakhir diperbarui dalam format ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

role string  (opsional)

Hanya output. Peran interaksi.

outputs array (Content)  (opsional)

Hanya output. Respons dari model.

system_instruction string  (opsional)

Petunjuk sistem untuk interaksi.

tools array (Tool)  (opsional)

Daftar deklarasi alat yang dapat dipanggil model selama interaksi.

penggunaan Penggunaan  (opsional)

Hanya output. Statistik penggunaan token permintaan interaksi.

Statistik penggunaan token permintaan interaksi.

Kolom

total_input_tokens integer  (opsional)

Jumlah token dalam perintah (konteks).

input_tokens_by_modality ModalityTokens  (opsional)

Perincian penggunaan token input menurut modalitas.

Jumlah token untuk modalitas respons tunggal.

Kolom

modality ResponseModality  (opsional)

Modalitas yang terkait dengan jumlah token.

Nilai yang mungkin:

  • text
  • image
  • audio

token integer  (opsional)

Jumlah token untuk modalitas.

total_cached_tokens integer  (opsional)

Jumlah token di bagian perintah yang di-cache (konten yang di-cache).

cached_tokens_by_modality ModalityTokens  (opsional)

Perincian penggunaan token yang di-cache menurut modalitas.

Jumlah token untuk modalitas respons tunggal.

Kolom

modality ResponseModality  (opsional)

Modalitas yang terkait dengan jumlah token.

Nilai yang mungkin:

  • text
  • image
  • audio

token integer  (opsional)

Jumlah token untuk modalitas.

total_output_tokens integer  (opsional)

Jumlah total token di semua respons yang dihasilkan.

output_tokens_by_modality ModalityTokens  (opsional)

Perincian penggunaan token output menurut modalitas.

Jumlah token untuk modalitas respons tunggal.

Kolom

modality ResponseModality  (opsional)

Modalitas yang terkait dengan jumlah token.

Nilai yang mungkin:

  • text
  • image
  • audio

token integer  (opsional)

Jumlah token untuk modalitas.

total_tool_use_tokens integer  (opsional)

Jumlah token yang ada dalam perintah penggunaan alat.

tool_use_tokens_by_modality ModalityTokens  (opsional)

Perincian penggunaan token penggunaan alat menurut modalitas.

Jumlah token untuk modalitas respons tunggal.

Kolom

modality ResponseModality  (opsional)

Modalitas yang terkait dengan jumlah token.

Nilai yang mungkin:

  • text
  • image
  • audio

token integer  (opsional)

Jumlah token untuk modalitas.

total_thought_tokens integer  (opsional)

Jumlah token pemikiran untuk model penalaran.

total_tokens integer  (opsional)

Jumlah total token untuk permintaan interaksi (prompt + respons + token internal lainnya).

response_modalities ResponseModality  (opsional)

Modalitas respons yang diminta (TEKS, GAMBAR, AUDIO).

Nilai yang mungkin:

  • text
  • image
  • audio

response_format object  (opsional)

Memastikan bahwa respons yang dihasilkan adalah objek JSON yang sesuai dengan skema JSON yang ditentukan dalam kolom ini.

response_mime_type string  (opsional)

Jenis MIME respons. Parameter ini diperlukan jika response_format ditetapkan.

previous_interaction_id string  (opsional)

ID interaksi sebelumnya, jika ada.

input Content atau array (Content) atau array (Turn) atau string  (wajib)

Input untuk interaksi (umum untuk Model dan Agen).

agent_config object  (opsional)

Parameter konfigurasi untuk interaksi agen.

Kemungkinan Jenis

Diskriminator polimorfik: type

DynamicAgentConfig

Konfigurasi untuk agen dinamis.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "dynamic".

DeepResearchAgentConfig

Konfigurasi untuk agen Deep Research.

thinking_summaries ThinkingSummaries  (opsional)

Apakah akan menyertakan ringkasan pemikiran dalam respons.

Nilai yang mungkin:

  • auto
  • none

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "deep-research".

Contoh

Contoh

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

Model Data

Konten

Konten respons.

Kemungkinan Jenis

Diskriminator polimorfik: type

TextContent

Blok konten teks.

text string  (wajib)

Konten teks.

annotations Annotation  (opsional)

Informasi kutipan untuk konten yang dihasilkan model.

Informasi kutipan untuk konten yang dihasilkan model.

Kemungkinan Jenis

Diskriminator polimorfik: type

UrlCitation

Anotasi kutipan URL.

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang diatribusikan untuk sebagian teks.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

place_id string  (opsional)

ID tempat, dalam format `places/{place_id}`.

name string  (opsional)

Judul tempat.

url string  (opsional)

Referensi URI tempat.

review_snippets ReviewSnippet  (opsional)

Cuplikan ulasan yang digunakan untuk membuat jawaban tentang fitur suatu tempat tertentu di Google Maps.

Mencakup cuplikan ulasan pengguna yang menjawab pertanyaan tentang fitur tempat tertentu di Google Maps.

Kolom

title string  (opsional)

Judul ulasan.

url string  (opsional)

Link yang sesuai dengan ulasan pengguna di Google Maps.

review_id string  (opsional)

ID cuplikan ulasan.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

ImageContent

Blok konten gambar.

data string  (opsional)

Konten gambar.

uri string  (opsional)

URI gambar.

mime_type enum (string)  (opsional)

Jenis MIME gambar.

Nilai yang mungkin:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

AudioContent

Blok konten audio.

data string  (opsional)

Konten audio.

uri string  (opsional)

URI audio.

mime_type enum (string)  (opsional)

Jenis MIME audio.

Nilai yang mungkin:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "audio".

DocumentContent

Blok konten dokumen.

data string  (opsional)

Konten dokumen.

uri string  (opsional)

URI dokumen.

mime_type enum (string)  (opsional)

Jenis MIME dokumen.

Nilai yang mungkin:

  • application/pdf
type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "document".

VideoContent

Blok konten video.

data string  (opsional)

Konten video.

uri string  (opsional)

URI video.

mime_type enum (string)  (opsional)

Jenis MIME video.

Nilai yang mungkin:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "video".

ThoughtContent

Blok konten pemikiran.

signature string  (opsional)

Tanda tangan agar sesuai dengan sumber backend yang akan menjadi bagian dari pembuatan.

summary ThoughtSummaryContent  (opsional)

Ringkasan pemikiran.

Kemungkinan Jenis

Diskriminator polimorfik: type

TextContent

Blok konten teks.

text string  (wajib)

Konten teks.

annotations Annotation  (opsional)

Informasi kutipan untuk konten yang dihasilkan model.

Informasi kutipan untuk konten yang dihasilkan model.

Kemungkinan Jenis

Diskriminator polimorfik: type

UrlCitation

Anotasi kutipan URL.

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang diatribusikan untuk sebagian teks.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

place_id string  (opsional)

ID tempat, dalam format `places/{place_id}`.

name string  (opsional)

Judul tempat.

url string  (opsional)

Referensi URI tempat.

review_snippets ReviewSnippet  (opsional)

Cuplikan ulasan yang digunakan untuk membuat jawaban tentang fitur suatu tempat tertentu di Google Maps.

Mencakup cuplikan ulasan pengguna yang menjawab pertanyaan tentang fitur tempat tertentu di Google Maps.

Kolom

title string  (opsional)

Judul ulasan.

url string  (opsional)

Link yang sesuai dengan ulasan pengguna di Google Maps.

review_id string  (opsional)

ID cuplikan ulasan.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

ImageContent

Blok konten gambar.

data string  (opsional)

Konten gambar.

uri string  (opsional)

URI gambar.

mime_type enum (string)  (opsional)

Jenis MIME gambar.

Nilai yang mungkin:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought".

FunctionCallContent

Blok konten panggilan alat fungsi.

name string  (wajib)

Nama alat yang akan dipanggil.

argumen object  (wajib)

Argumen yang akan diteruskan ke fungsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FunctionResultContent

Blok konten hasil alat fungsi.

name string  (opsional)

Nama alat yang dipanggil.

is_error boolean  (opsional)

Apakah panggilan alat menghasilkan error.

result array (FunctionResultSubcontent) atau string  (wajib)

Hasil panggilan alat.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

CodeExecutionCallContent

Konten eksekusi kode.

arguments CodeExecutionCallArguments  (wajib)

Argumen yang akan diteruskan ke eksekusi kode.

Argumen yang akan diteruskan ke eksekusi kode.

Kolom

language enum (string)  (opsional)

Bahasa pemrograman `code`.

Nilai yang mungkin:

  • python
code string  (opsional)

Kode yang akan dieksekusi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

CodeExecutionResultContent

Konten hasil eksekusi kode.

result string  (wajib)

Output eksekusi kode.

is_error boolean  (opsional)

Apakah eksekusi kode menghasilkan error.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_result".

call_id string  (wajib)

ID untuk mencocokkan ID dari blok panggilan eksekusi kode.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextCallContent

Konten konteks URL.

arguments UrlContextCallArguments  (wajib)

Argumen yang akan diteruskan ke konteks URL.

Argumen yang akan diteruskan ke konteks URL.

Kolom

urls array (string)  (opsional)

URL yang akan di-fetch.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextResultContent

Konten hasil konteks URL.

result UrlContextResult  (wajib)

Hasil konteks URL.

Hasil konteks URL.

Kolom

url string  (opsional)

URL yang diambil.

status enum (string)  (opsional)

Status pengambilan URL.

Nilai yang mungkin:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (opsional)

Apakah konteks URL menyebabkan error.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_result".

call_id string  (wajib)

ID untuk mencocokkan ID dari blok panggilan konteks URL.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchCallContent

Konten Google Penelusuran.

arguments GoogleSearchCallArguments  (wajib)

Argumen yang akan diteruskan ke Google Penelusuran.

Argumen yang akan diteruskan ke Google Penelusuran.

Kolom

queries array (string)  (opsional)

Kueri penelusuran web untuk penelusuran web lanjutan.

search_type enum (string)  (opsional)

Jenis perujukan penelusuran yang diaktifkan.

Nilai yang mungkin:

  • web_search
  • image_search
type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchResultContent

Konten hasil Google Penelusuran.

result GoogleSearchResult  (wajib)

Hasil Google Penelusuran.

Hasil Google Penelusuran.

Kolom

search_suggestions string  (opsional)

Cuplikan konten web yang dapat disematkan di halaman web atau webview aplikasi.

is_error boolean  (opsional)

Apakah Penelusuran Google menghasilkan error.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_result".

call_id string  (wajib)

ID yang cocok dengan ID dari pemblokiran panggilan penelusuran Google.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolCallContent

Konten panggilan alat MCPServer.

name string  (wajib)

Nama alat yang dipanggil.

server_name string  (wajib)

Nama server MCP yang digunakan.

argumen object  (wajib)

Objek JSON argumen untuk fungsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolResultContent

Konten hasil alat MCPServer.

name string  (opsional)

Nama alat yang dipanggil untuk panggilan alat tertentu ini.

server_name string  (opsional)

Nama server MCP yang digunakan.

result array (FunctionResultSubcontent) atau string  (wajib)

Output dari panggilan server MCP. Dapat berupa teks sederhana atau konten multimedia.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan alat server MCP.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FileSearchCallContent

Konten Penelusuran File.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FileSearchResultContent

Konten hasil Penelusuran File.

result FileSearchResult  (opsional)

Hasil Penelusuran File.

Hasil Penelusuran File.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_result".

call_id string  (wajib)

ID yang cocok dengan ID dari pemblokiran panggilan penelusuran file.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsCallContent

Konten Google Maps.

arguments GoogleMapsCallArguments  (opsional)

Argumen yang akan diteruskan ke alat Google Maps.

Argumen yang akan diteruskan ke alat Google Maps.

Kolom

queries array (string)  (opsional)

Kueri yang akan dieksekusi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsResultContent

Konten hasil Google Maps.

result GoogleMapsResult  (wajib)

Hasil Google Maps.

Hasil Google Maps.

Kolom

tempat Tempat  (opsional)

Tempat yang ditemukan.

Kolom

place_id string  (opsional)

ID tempat, dalam format `places/{place_id}`.

name string  (opsional)

Judul tempat.

url string  (opsional)

Referensi URI tempat.

review_snippets ReviewSnippet  (opsional)

Cuplikan ulasan yang digunakan untuk membuat jawaban tentang fitur suatu tempat tertentu di Google Maps.

Mencakup cuplikan ulasan pengguna yang menjawab pertanyaan tentang fitur tempat tertentu di Google Maps.

Kolom

title string  (opsional)

Judul ulasan.

url string  (opsional)

Link yang sesuai dengan ulasan pengguna di Google Maps.

review_id string  (opsional)

ID cuplikan ulasan.

widget_context_token string  (opsional)

Nama resource token konteks widget Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan google maps.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

Contoh

Teks

{
  "type": "text",
  "text": "Hello, how are you?"
}

Gambar

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

Audio

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

Dokumen

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

Video

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

Berpikir

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

Panggilan Fungsi

{
  "type": "function_call",
  "name": "get_weather",
  "id": "gth23981",
  "arguments": {
    "location": "Boston, MA"
  }
}

Hasil Fungsi

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": [
    {
      "type": "text",
      "text": "{\"weather\":\"sunny\"}"
    }
  ]
}

Panggilan Eksekusi Kode

{
  "type": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

Hasil Eksekusi Kode

{
  "type": "code_execution_result",
  "call_id": "call_123456",
  "result": "hello world"
}

Panggilan Konteks URL

{
  "type": "url_context_call",
  "id": "call_123456",
  "arguments": {
    "urls": [
      "https://www.example.com"
    ]
  }
}

Hasil Konteks URL

{
  "type": "url_context_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.example.com",
      "status": "SUCCESS"
    }
  ]
}

Panggilan Google Penelusuran

{
  "type": "google_search_call",
  "id": "call_123456",
  "arguments": {
    "queries": [
      "weather in Boston"
    ]
  }
}

Hasil Penelusuran Google

{
  "type": "google_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.google.com/search?q=weather+in+Boston",
      "title": "Weather in Boston"
    }
  ]
}

Panggilan Alat Server MCP

{
  "type": "mcp_server_tool_call",
  "id": "call_123456",
  "name": "get_forecast",
  "server_name": "weather_server",
  "arguments": {
    "city": "London"
  }
}

Hasil Alat Server MCP

{
  "type": "mcp_server_tool_result",
  "name": "get_forecast",
  "server_name": "weather_server",
  "call_id": "call_123456",
  "result": "sunny"
}

Panggilan Penelusuran File

{
  "type": "file_search_call",
  "id": "call_123456"
}

Hasil Penelusuran File

{
  "type": "file_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

Panggilan Google Maps

{
  "type": "google_maps_call",
  "id": "call_123456",
  "arguments": {
    "query": "best food near me"
  }
}

Hasil Google Maps

{
  "type": "google_maps_result",
  "call_id": "call_123456",
  "result": [
    {
      "places": [
        {
          "url": "https://www.google.com/maps/search/best+food+near+me",
          "name": "Tasty Restaurant"
        }
      ]
    }
  ]
}

Alat

Kemungkinan Jenis

Diskriminator polimorfik: type

Fungsi

Alat yang dapat digunakan oleh model.

name string  (opsional)

Nama fungsi.

description string  (opsional)

Deskripsi fungsi.

parameter object  (opsional)

Skema JSON untuk parameter fungsi.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function".

GoogleSearch

Alat yang dapat digunakan oleh model untuk menelusuri Google.

search_types array (enum (string))  (opsional)

Jenis perujukan penelusuran yang akan diaktifkan.

Nilai yang mungkin:

  • web_search
  • image_search
type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search".

CodeExecution

Alat yang dapat digunakan oleh model untuk mengeksekusi kode.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution".

UrlContext

Alat yang dapat digunakan oleh model untuk mengambil konteks URL.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context".

ComputerUse

Alat yang dapat digunakan oleh model untuk berinteraksi dengan komputer.

environment enum (string)  (opsional)

Lingkungan yang dioperasikan.

Nilai yang mungkin:

  • browser
excludedPredefinedFunctions array (string)  (opsional)

Daftar fungsi standar yang dikecualikan dari panggilan model.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "computer_use".

McpServer

MCPServer adalah server yang dapat dipanggil oleh model untuk melakukan tindakan.

name string  (opsional)

Nama MCPServer.

url string  (opsional)

URL lengkap untuk endpoint MCPServer. Contoh: "https://api.example.com/mcp"

headers object  (opsional)

Opsional: Kolom untuk header autentikasi, waktu tunggu, dll., jika diperlukan.

allowed_tools AllowedTools  (opsional)

Alat yang diizinkan.

Konfigurasi untuk alat yang diizinkan.

Kolom

mode ToolChoiceType  (opsional)

Mode pilihan alat.

Nilai yang mungkin:

  • auto
  • any
  • none
  • validated

tools array (string)  (opsional)

Nama alat yang diizinkan.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server".

FileSearch

Alat yang dapat digunakan oleh model untuk menelusuri file.

file_search_store_names array (string)  (opsional)

Nama penyimpanan penelusuran file yang akan ditelusuri.

top_k integer  (opsional)

Jumlah potongan pengambilan semantik yang akan diambil.

metadata_filter string  (opsional)

Filter metadata yang akan diterapkan ke dokumen dan potongan pengambilan semantik.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search".

GoogleMaps

Alat yang dapat digunakan oleh model untuk memanggil Google Maps.

enable_widget boolean  (opsional)

Apakah akan menampilkan token konteks widget dalam hasil panggilan alat respons.

latitude number  (opsional)

Garis lintang lokasi pengguna.

longitude number  (opsional)

Garis bujur lokasi pengguna.

type string  (opsional)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps".

Contoh

Fungsi

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

GoogleMaps

CANNOT TRANSLATE

Kolom

role string  (opsional)

Pemrakarsa giliran ini. Harus berupa pengguna untuk input atau model untuk output model.

content array (Content) atau string  (opsional)

Konten giliran.

Contoh

Giliran Pengguna

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

Putaran Model

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

Kemungkinan Jenis

Diskriminator polimorfik: event_type

InteractionStartEvent

interaksi Interaksi  (wajib diisi)

Tidak tersedia deskripsi.

event_type enum (string)  (wajib)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • interaction.start
event_id string  (opsional)

Token event_id yang akan digunakan untuk melanjutkan aliran interaksi, dari peristiwa ini.

InteractionCompleteEvent

interaksi Interaksi  (wajib diisi)

Interaksi yang telah selesai dengan output kosong untuk mengurangi ukuran payload. Gunakan peristiwa ContentDelta sebelumnya untuk output sebenarnya.

event_type enum (string)  (wajib)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • interaction.complete
event_id string  (opsional)

Token event_id yang akan digunakan untuk melanjutkan aliran interaksi, dari peristiwa ini.

InteractionStatusUpdate

interaction_id string  (wajib)

Tidak tersedia deskripsi.

status enum (string)  (wajib)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "interaction.status_update".

event_id string  (opsional)

Token event_id yang akan digunakan untuk melanjutkan aliran interaksi, dari peristiwa ini.

ContentStart

index integer  (wajib ada)

Tidak tersedia deskripsi.

konten Konten  (wajib)

Tidak tersedia deskripsi.

event_type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "content.start".

event_id string  (opsional)

Token event_id yang akan digunakan untuk melanjutkan aliran interaksi, dari peristiwa ini.

ContentDelta

index integer  (wajib ada)

Tidak tersedia deskripsi.

delta object  (wajib ada)

Tidak tersedia deskripsi.

Kemungkinan Jenis

Diskriminator polimorfik: type

TextDelta

text string  (wajib)

Tidak tersedia deskripsi.

annotations Annotation  (opsional)

Informasi kutipan untuk konten yang dihasilkan model.

Informasi kutipan untuk konten yang dihasilkan model.

Kemungkinan Jenis

Diskriminator polimorfik: type

UrlCitation

Anotasi kutipan URL.

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang diatribusikan untuk sebagian teks.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

place_id string  (opsional)

ID tempat, dalam format `places/{place_id}`.

name string  (opsional)

Judul tempat.

url string  (opsional)

Referensi URI tempat.

review_snippets ReviewSnippet  (opsional)

Cuplikan ulasan yang digunakan untuk membuat jawaban tentang fitur suatu tempat tertentu di Google Maps.

Mencakup cuplikan ulasan pengguna yang menjawab pertanyaan tentang fitur tempat tertentu di Google Maps.

Kolom

title string  (opsional)

Judul ulasan.

url string  (opsional)

Link yang sesuai dengan ulasan pengguna di Google Maps.

review_id string  (opsional)

ID cuplikan ulasan.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

ImageDelta

data string  (opsional)

Tidak tersedia deskripsi.

uri string  (opsional)

Tidak tersedia deskripsi.

mime_type enum (string)  (opsional)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

AudioDelta

data string  (opsional)

Tidak tersedia deskripsi.

uri string  (opsional)

Tidak tersedia deskripsi.

mime_type enum (string)  (opsional)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "audio".

DocumentDelta

data string  (opsional)

Tidak tersedia deskripsi.

uri string  (opsional)

Tidak tersedia deskripsi.

mime_type enum (string)  (opsional)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • application/pdf
type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "document".

VideoDelta

data string  (opsional)

Tidak tersedia deskripsi.

uri string  (opsional)

Tidak tersedia deskripsi.

mime_type enum (string)  (opsional)

Tidak tersedia deskripsi.

Nilai yang mungkin:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "video".

ThoughtSummaryDelta

content ThoughtSummaryContent  (opsional)

Item ringkasan baru yang akan ditambahkan ke pemikiran.

Kemungkinan Jenis

Diskriminator polimorfik: type

TextContent

Blok konten teks.

text string  (wajib)

Konten teks.

annotations Annotation  (opsional)

Informasi kutipan untuk konten yang dihasilkan model.

Informasi kutipan untuk konten yang dihasilkan model.

Kemungkinan Jenis

Diskriminator polimorfik: type

UrlCitation

Anotasi kutipan URL.

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang diatribusikan untuk sebagian teks.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

place_id string  (opsional)

ID tempat, dalam format `places/{place_id}`.

name string  (opsional)

Judul tempat.

url string  (opsional)

Referensi URI tempat.

review_snippets ReviewSnippet  (opsional)

Cuplikan ulasan yang digunakan untuk membuat jawaban tentang fitur suatu tempat tertentu di Google Maps.

Mencakup cuplikan ulasan pengguna yang menjawab pertanyaan tentang fitur tempat tertentu di Google Maps.

Kolom

title string  (opsional)

Judul ulasan.

url string  (opsional)

Link yang sesuai dengan ulasan pengguna di Google Maps.

review_id string  (opsional)

ID cuplikan ulasan.

type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

ImageContent

Blok konten gambar.

data string  (opsional)

Konten gambar.

uri string  (opsional)

URI gambar.

mime_type enum (string)  (opsional)

Jenis MIME gambar.

Nilai yang mungkin:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought_summary".

ThoughtSignatureDelta

signature string  (opsional)

Tanda tangan agar sesuai dengan sumber backend yang akan menjadi bagian dari pembuatan.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought_signature".

FunctionCallDelta

name string  (wajib)

Tidak tersedia deskripsi.

argumen object  (wajib)

Tidak tersedia deskripsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FunctionResultDelta

name string  (opsional)

Tidak tersedia deskripsi.

is_error boolean  (opsional)

Tidak tersedia deskripsi.

result objek atau string  (wajib)

Delta hasil panggilan alat.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (wajib)

Tidak tersedia deskripsi.

Argumen yang akan diteruskan ke eksekusi kode.

Kolom

language enum (string)  (opsional)

Bahasa pemrograman `code`.

Nilai yang mungkin:

  • python
code string  (opsional)

Kode yang akan dieksekusi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

CodeExecutionResultDelta

result string  (wajib)

Tidak tersedia deskripsi.

is_error boolean  (opsional)

Tidak tersedia deskripsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextCallDelta

arguments UrlContextCallArguments  (wajib)

Tidak tersedia deskripsi.

Argumen yang akan diteruskan ke konteks URL.

Kolom

urls array (string)  (opsional)

URL yang akan di-fetch.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextResultDelta

result UrlContextResult  (wajib)

Tidak tersedia deskripsi.

Hasil konteks URL.

Kolom

url string  (opsional)

URL yang diambil.

status enum (string)  (opsional)

Status pengambilan URL.

Nilai yang mungkin:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (opsional)

Tidak tersedia deskripsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (wajib)

Tidak tersedia deskripsi.

Argumen yang akan diteruskan ke Google Penelusuran.

Kolom

queries array (string)  (opsional)

Kueri penelusuran web untuk penelusuran web lanjutan.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchResultDelta

result GoogleSearchResult  (wajib)

Tidak tersedia deskripsi.

Hasil Google Penelusuran.

Kolom

search_suggestions string  (opsional)

Cuplikan konten web yang dapat disematkan di halaman web atau webview aplikasi.

is_error boolean  (opsional)

Tidak tersedia deskripsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolCallDelta

name string  (wajib)

Tidak tersedia deskripsi.

server_name string  (wajib)

Tidak tersedia deskripsi.

argumen object  (wajib)

Tidak tersedia deskripsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolResultDelta

name string  (opsional)

Tidak tersedia deskripsi.

server_name string  (opsional)

Tidak tersedia deskripsi.

result objek atau string  (wajib)

Delta hasil panggilan alat.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FileSearchCallDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FileSearchResultDelta

result FileSearchResult  (opsional)

Tidak tersedia deskripsi.

Hasil Penelusuran File.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsCallDelta

arguments GoogleMapsCallArguments  (opsional)

Argumen yang akan diteruskan ke alat Google Maps.

Argumen yang akan diteruskan ke alat Google Maps.

Kolom

queries array (string)  (opsional)

Kueri yang akan dieksekusi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_call".

id string  (wajib)

ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsResultDelta

result GoogleMapsResult  (wajib)

Hasil Google Maps.

Hasil Google Maps.

Kolom

tempat Tempat  (opsional)

Tempat yang ditemukan.

Kolom

place_id string  (opsional)

ID tempat, dalam format `places/{place_id}`.

name string  (opsional)

Judul tempat.

url string  (opsional)

Referensi URI tempat.

review_snippets ReviewSnippet  (opsional)

Cuplikan ulasan yang digunakan untuk membuat jawaban tentang fitur suatu tempat tertentu di Google Maps.

Mencakup cuplikan ulasan pengguna yang menjawab pertanyaan tentang fitur tempat tertentu di Google Maps.

Kolom

title string  (opsional)

Judul ulasan.

url string  (opsional)

Link yang sesuai dengan ulasan pengguna di Google Maps.

review_id string  (opsional)

ID cuplikan ulasan.

widget_context_token string  (opsional)

Nama resource token konteks widget Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_result".

call_id string  (wajib)

ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

event_type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "content.delta".

event_id string  (opsional)

Token event_id yang akan digunakan untuk melanjutkan aliran interaksi, dari peristiwa ini.

ContentStop

index integer  (wajib ada)

Tidak tersedia deskripsi.

event_type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "content.stop".

event_id string  (opsional)

Token event_id yang akan digunakan untuk melanjutkan aliran interaksi, dari peristiwa ini.

ErrorEvent

error Error  (opsional)

Tidak tersedia deskripsi.

Pesan error dari interaksi.

Kolom

code string  (opsional)

URI yang mengidentifikasi jenis error.

message string  (opsional)

Pesan error yang dapat dibaca manusia.

event_type string  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "error".

event_id string  (opsional)

Token event_id yang akan digunakan untuk melanjutkan aliran interaksi, dari peristiwa ini.

Contoh

Awal Interaksi

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "status": "in_progress"
  }
}

Interaksi Selesai

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "role": "model",
    "status": "completed",
    "updated": "2025-12-09T18:45:40Z",
    "usage": {
      "input_tokens_by_modality": [
        {
          "modality": "text",
          "tokens": 11
        }
      ],
      "total_cached_tokens": 0,
      "total_input_tokens": 11,
      "total_output_tokens": 364,
      "total_thought_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

Pembaruan Status Interaksi

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

Awal Konten

{
  "event_type": "content.start",
  "content": {
    "type": "text"
  },
  "index": 1
}

Perubahan Konten

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

Penghentian Konten

{
  "event_type": "content.stop",
  "index": 1
}

Peristiwa Error

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}