Gemini API

Gemini Interactions API adalah API eksperimental yang memungkinkan developer membuat aplikasi AI generatif menggunakan model Gemini. Gemini adalah model kami yang paling canggih, 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-computer-use-preview-10-2025

    Model kemampuan agentic yang dirancang untuk interaksi antarmuka langsung, sehingga Gemini dapat memahami dan menjelajahi lingkungan digital.

  • gemini-2.5-flash

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

  • gemini-2.5-flash-image

    Model pembuatan gambar native kami, yang dioptimalkan untuk kecepatan, fleksibilitas, dan pemahaman kontekstual. Input dan output teks memiliki harga yang 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 tempo, kealamian suara, panjang kata, 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, latensi rendah, tugas bervolume tinggi yang memerlukan penalaran, dan 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 sesuai dengan kenyataan.

  • gemini-3.1-flash-lite-preview

    Model kami yang paling hemat biaya, dioptimalkan untuk tugas agentic bervolume tinggi, terjemahan, dan pemrosesan data sederhana.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Pembuatan ucapan yang efektif dengan latensi rendah. Nikmati output yang alami, perintah yang dapat diarahkan, dan tag audio ekspresif baru untuk kontrol narasi yang presisi.

  • lyria-3-clip-preview

    Model pembuatan musik berlatensi rendah kami dioptimalkan untuk klip audio fidelitas tinggi dan kontrol ritmik yang presisi.

  • lyria-3-pro-preview

    Model generatif lagu lengkap canggih kami dengan pemahaman komposisi yang mendalam, dioptimalkan untuk kontrol struktural yang presisi dan transisi kompleks di berbagai gaya musik.

Model yang akan melengkapi 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

  • deep-research-preview-04-2026

    Agen Deep Research Gemini

  • deep-research-max-preview-04-2026

    Agen Deep Research Max Gemini

Agen yang akan diajak 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 speaker.

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)

Konfigurasi pilihan alat.

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "deep-research".

thinking_summaries ThinkingSummaries  (opsional)

Apakah akan menyertakan ringkasan pemikiran dalam respons.

Nilai yang mungkin:

  • auto
  • none

visualisasi enum (string)  (opsional)

Apakah akan menyertakan visualisasi dalam respons.

Nilai yang mungkin:

  • off
  • auto
collaborative_planning boolean  (opsional)

Memungkinkan perencanaan dengan interaksi manusia untuk agen Deep Research. Jika disetel ke benar (true), agen Deep Research akan memberikan rencana riset dalam responsnya. Kemudian, agen hanya akan melanjutkan jika pengguna mengonfirmasi rencana tersebut pada giliran berikutnya.

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
  • video
  • document

service_tier enum (string)  (opsional)

Tingkat layanan untuk interaksi.

Nilai yang mungkin:

  • flex
  • standard
  • priority

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-computer-use-preview-10-2025

    Model kemampuan agentic yang dirancang untuk interaksi antarmuka langsung, sehingga Gemini dapat memahami dan menjelajahi lingkungan digital.

  • gemini-2.5-flash

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

  • gemini-2.5-flash-image

    Model pembuatan gambar native kami, yang dioptimalkan untuk kecepatan, fleksibilitas, dan pemahaman kontekstual. Input dan output teks memiliki harga yang 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 tempo, kealamian suara, panjang kata, 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, latensi rendah, tugas bervolume tinggi yang memerlukan penalaran, dan 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 sesuai dengan kenyataan.

  • gemini-3.1-flash-lite-preview

    Model kami yang paling hemat biaya, dioptimalkan untuk tugas agentic bervolume tinggi, terjemahan, dan pemrosesan data sederhana.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Pembuatan ucapan yang efektif dengan latensi rendah. Nikmati output yang alami, perintah yang dapat diarahkan, dan tag audio ekspresif baru untuk kontrol narasi yang presisi.

  • lyria-3-clip-preview

    Model pembuatan musik berlatensi rendah kami dioptimalkan untuk klip audio fidelitas tinggi dan kontrol ritmik yang presisi.

  • lyria-3-pro-preview

    Model generatif lagu lengkap canggih kami dengan pemahaman komposisi yang mendalam, dioptimalkan untuk kontrol struktural yang presisi dan transisi kompleks di berbagai gaya musik.

Model yang akan melengkapi 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

  • deep-research-preview-04-2026

    Agen Deep Research Gemini

  • deep-research-max-preview-04-2026

    Agen Deep Research Max Gemini

Agen yang akan diajak berinteraksi.

id string  (opsional)

Wajib. Hanya output. ID unik untuk penyelesaian interaksi.

status enum (string)  (opsional)

Wajib. Hanya output. Status interaksi.

Nilai yang mungkin:

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

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

updated string  (opsional)

Wajib. 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
  • video
  • document

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
  • video
  • document

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
  • video
  • document

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
  • video
  • document

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
  • video
  • document

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.

service_tier enum (string)  (opsional)

Tingkat layanan untuk interaksi.

Nilai yang mungkin:

  • flex
  • standard
  • priority
input Content atau array (Content) atau array (Turn) atau string  (opsional)

Input untuk interaksi.

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "deep-research".

thinking_summaries ThinkingSummaries  (opsional)

Apakah akan menyertakan ringkasan pemikiran dalam respons.

Nilai yang mungkin:

  • auto
  • none

visualisasi enum (string)  (opsional)

Apakah akan menyertakan visualisasi dalam respons.

Nilai yang mungkin:

  • off
  • auto
collaborative_planning boolean  (opsional)

Memungkinkan perencanaan dengan interaksi manusia untuk agen Deep Research. Jika disetel ke benar (true), agen Deep Research akan memberikan rencana riset dalam responsnya. Kemudian, agen hanya akan melanjutkan jika pengguna mengonfirmasi rencana tersebut pada giliran berikutnya.

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

text string  (wajib)

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang dikaitkan untuk sebagian teks.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

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.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

ImageContent

Blok konten gambar.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

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
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Blok konten audio.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "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
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate integer  (opsional)

Frekuensi sampel audio.

channels integer  (opsional)

Jumlah saluran audio.

DocumentContent

Blok konten dokumen.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "document".

data string  (opsional)

Konten dokumen.

uri string  (opsional)

URI dokumen.

mime_type enum (string)  (opsional)

Jenis MIME dokumen.

Nilai yang mungkin:

  • application/pdf
VideoContent

Blok konten video.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "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

ThoughtContent

Blok konten pemikiran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought".

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

text string  (wajib)

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang dikaitkan untuk sebagian teks.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

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.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

ImageContent

Blok konten gambar.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

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
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

FunctionCallContent

Blok konten panggilan alat fungsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_call".

name string  (wajib)

Wajib. Nama alat yang akan dipanggil.

argumen object  (wajib)

Wajib. Argumen yang akan diteruskan ke fungsi.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

CodeExecutionCallContent

Konten eksekusi kode.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_call".

arguments CodeExecutionCallArguments  (wajib)

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.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextCallContent

Konten konteks URL.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_call".

arguments UrlContextCallArguments  (wajib)

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.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolCallContent

Konten panggilan alat MCPServer.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_call".

name string  (wajib)

Wajib. Nama alat yang dipanggil.

server_name string  (wajib)

Wajib. Nama server MCP yang digunakan.

argumen object  (wajib)

Wajib. Objek JSON argumen untuk fungsi.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchCallContent

Konten Google Penelusuran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_call".

arguments GoogleSearchCallArguments  (wajib)

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
  • enterprise_web_search
id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

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)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsCallContent

Konten Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_call".

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.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FunctionResultContent

Blok konten hasil alat fungsi.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_result".

name string  (opsional)

Nama alat yang dipanggil.

is_error boolean  (opsional)

Apakah panggilan alat menghasilkan error.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

result array (FunctionResultSubcontent) atau string  (wajib)

Hasil panggilan alat.

CodeExecutionResultContent

Konten hasil eksekusi kode.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_result".

result string  (wajib)

Wajib. Output eksekusi kode.

is_error boolean  (opsional)

Apakah eksekusi kode menghasilkan error.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextResultContent

Konten hasil konteks URL.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_result".

result UrlContextResult  (wajib)

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.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchResultContent

Konten hasil Google Penelusuran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_result".

result GoogleSearchResult  (wajib)

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.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolResultContent

Konten hasil alat MCPServer.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_result".

name string  (opsional)

Nama alat yang dipanggil untuk panggilan alat tertentu ini.

server_name string  (opsional)

Nama server MCP yang digunakan.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

result array (FunctionResultSubcontent) atau string  (wajib)

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

FileSearchResultContent

Konten hasil Penelusuran File.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_result".

result FileSearchResult  (wajib)

Wajib. Hasil Penelusuran File.

Hasil Penelusuran File.

Kolom

custom_metadata array (object)  (opsional)

Metadata yang disediakan pengguna tentang FileSearchResult.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsResultContent

Konten hasil Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_result".

result GoogleMapsResult  (wajib)

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.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

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"
  }
}

Panggilan Eksekusi Kode

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

Panggilan Konteks URL

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

Panggilan Alat Server MCP

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

Panggilan Google Penelusuran

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

Panggilan Penelusuran File

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

Panggilan Google Maps

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

Hasil Fungsi

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

Hasil Eksekusi Kode

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

Hasil Konteks URL

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

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"
    }
  ]
}

Hasil Alat Server MCP

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

Hasil Penelusuran File

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

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

Alat yang dapat digunakan oleh model.

Kemungkinan Jenis

Diskriminator polimorfik: type

Fungsi

Alat yang dapat digunakan oleh model.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function".

name string  (opsional)

Nama fungsi.

description string  (opsional)

Deskripsi fungsi.

parameter object  (opsional)

Skema JSON untuk parameter fungsi.

CodeExecution

Alat yang dapat digunakan oleh model untuk mengeksekusi kode.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution".

UrlContext

Alat yang dapat digunakan oleh model untuk mengambil konteks URL.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context".

ComputerUse

Alat yang dapat digunakan oleh model untuk berinteraksi dengan komputer.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "computer_use".

environment enum (string)  (opsional)

Lingkungan yang dioperasikan.

Nilai yang mungkin:

  • browser
excludedPredefinedFunctions array (string)  (opsional)

Daftar fungsi standar yang dikecualikan dari panggilan model.

McpServer

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

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server".

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.

GoogleSearch

Alat yang dapat digunakan oleh model untuk menelusuri Google.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search".

search_types array (enum (string))  (opsional)

Jenis perujukan penelusuran yang akan diaktifkan.

Nilai yang mungkin:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

Alat yang dapat digunakan oleh model untuk menelusuri file.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search".

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.

GoogleMaps

Alat yang dapat digunakan oleh model untuk memanggil Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "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.

Pengambilan

Alat yang dapat digunakan oleh model untuk mengambil file.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "retrieval".

retrieval_types array (enum (string))  (opsional)

Jenis pengambilan file yang akan diaktifkan.

Nilai yang mungkin:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (opsional)

Digunakan untuk menentukan konfigurasi VertexAISearch.

Digunakan untuk menentukan konfigurasi VertexAISearch.

Kolom

engine string  (opsional)

Opsional. Digunakan untuk menentukan mesin telusur Vertex AI Search.

datastores array (string)  (opsional)

Opsional. Digunakan untuk menentukan datastore Vertex AI Search.

Contoh

Fungsi

CodeExecution

UrlContext

ComputerUse

McpServer

GoogleSearch

FileSearch

GoogleMaps

Retrieval (Pengambilan Informasi)

Tidak ada contoh yang tersedia untuk jenis ini.

CANNOT TRANSLATE

Kolom

role string  (opsional)

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

content array (Content) atau string  (opsional)

Tidak tersedia deskripsi.

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

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "interaction.start".

interaksi Interaksi  (wajib diisi)

Tidak tersedia deskripsi.

event_id string  (opsional)

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

InteractionCompleteEvent

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "interaction.complete".

interaksi Interaksi  (wajib diisi)

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

event_id string  (opsional)

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

InteractionStatusUpdate

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "interaction.status_update".

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_id string  (opsional)

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

ContentStart

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "content.start".

index integer  (wajib ada)

Tidak tersedia deskripsi.

konten Konten  (wajib)

Tidak tersedia deskripsi.

event_id string  (opsional)

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

ContentDelta

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "content.delta".

index integer  (wajib ada)

Tidak tersedia deskripsi.

delta ContentDeltaData  (wajib)

Tidak tersedia deskripsi.

Data konten delta untuk blok konten.

Kemungkinan Jenis

Diskriminator polimorfik: type

TextDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

text string  (wajib)

Tidak tersedia deskripsi.

ImageDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

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
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "audio".

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
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate integer  (opsional)

Frekuensi sampel audio.

channels integer  (opsional)

Jumlah saluran audio.

DocumentDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "document".

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
VideoDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "video".

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

ThoughtSummaryDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought_summary".

content ThoughtSummaryContent  (opsional)

Item ringkasan baru yang akan ditambahkan ke pemikiran.

Kemungkinan Jenis

Diskriminator polimorfik: type

TextContent

Blok konten teks.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text".

text string  (wajib)

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang dikaitkan untuk sebagian teks.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

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.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

ImageContent

Blok konten gambar.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "image".

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
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (opsional)

Resolusi media.

Nilai yang mungkin:

  • low
  • medium
  • high
  • ultra_high

ThoughtSignatureDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought_signature".

signature string  (opsional)

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

FunctionCallDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_call".

name string  (wajib)

Tidak tersedia deskripsi.

argumen object  (wajib)

Tidak tersedia deskripsi.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

CodeExecutionCallDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_call".

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.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextCallDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_call".

arguments UrlContextCallArguments  (wajib)

Tidak tersedia deskripsi.

Argumen yang akan diteruskan ke konteks URL.

Kolom

urls array (string)  (opsional)

URL yang akan di-fetch.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchCallDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_call".

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.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolCallDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_call".

name string  (wajib)

Tidak tersedia deskripsi.

server_name string  (wajib)

Tidak tersedia deskripsi.

argumen object  (wajib)

Tidak tersedia deskripsi.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

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)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsCallDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_call".

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.

id string  (wajib)

Wajib. ID unik untuk panggilan alat tertentu ini.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

FunctionResultDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "function_result".

name string  (opsional)

Tidak tersedia deskripsi.

is_error boolean  (opsional)

Tidak tersedia deskripsi.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

result array (FunctionResultSubcontent) atau string  (wajib)

Tidak tersedia deskripsi.

CodeExecutionResultDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_result".

result string  (wajib)

Tidak tersedia deskripsi.

is_error boolean  (opsional)

Tidak tersedia deskripsi.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

UrlContextResultDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_result".

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.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleSearchResultDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_result".

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.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

McpServerToolResultDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "mcp_server_tool_result".

name string  (opsional)

Tidak tersedia deskripsi.

server_name string  (opsional)

Tidak tersedia deskripsi.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

result array (FunctionResultSubcontent) atau string  (wajib)

Tidak tersedia deskripsi.

FileSearchResultDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_result".

result FileSearchResult  (wajib)

Tidak tersedia deskripsi.

Hasil Penelusuran File.

Kolom

custom_metadata array (object)  (opsional)

Metadata yang disediakan pengguna tentang FileSearchResult.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsResultDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_result".

result GoogleMapsResult  (opsional)

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.

call_id string  (wajib)

Wajib. ID yang cocok dengan ID dari blok panggilan fungsi.

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

TextAnnotationDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text_annotation".

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.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_citation".

url string  (opsional)

URL.

title string  (opsional)

Judul URL.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

FileCitation

Anotasi kutipan file.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_citation".

document_uri string  (opsional)

URI file.

file_name string  (opsional)

Nama file.

source string  (opsional)

Sumber yang dikaitkan untuk sebagian teks.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

PlaceCitation

Anotasi kutipan tempat.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "place_citation".

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.

start_index integer  (opsional)

Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, diukur dalam byte.

end_index integer  (opsional)

Akhir segmen yang diatribusikan, eksklusif.

event_id string  (opsional)

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

ContentStop

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "content.stop".

index integer  (wajib ada)

Tidak tersedia deskripsi.

event_id string  (opsional)

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

ErrorEvent

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "error".

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_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"
  }
}