Gemini API

Gemini Interactions API adalah API eksperimental yang memungkinkan developer membuat aplikasi AI generatif menggunakan model Gemini. Gemini adalah model tercanggih kami, yang dibuat dari awal agar multimodal. Model ini dapat melakukan generalisasi dan dengan lancar memahami, beroperasi, serta 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 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 bervolume tinggi dengan latensi rendah yang memerlukan penalaran, dan kasus penggunaan berbasis agen.

  • 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.

  • 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 canggih 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 mendalam, yang 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 (Step) 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 ResponseFormat atau ResponseFormatList  (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 sampling.

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)

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 ServiceTier  (opsional)

Tingkat layanan untuk interaksi.

Nilai yang mungkin:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (opsional)

Opsional. Konfigurasi webhook untuk menerima notifikasi saat interaksi selesai.

Pesan untuk mengonfigurasi peristiwa webhook untuk permintaan.

Kolom

uris array (string)  (opsional)

Opsional. Jika ditetapkan, URI webhook ini akan digunakan untuk peristiwa webhook, bukan webhook yang terdaftar.

user_metadata object  (opsional)

Opsional. Metadata pengguna yang akan ditampilkan pada setiap pengiriman peristiwa ke webhook.

Respons

Menampilkan resource Interaction.

Permintaan Sederhana

Contoh Respons

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?"
        }
      ]
    }
  ],
  "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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",
  "steps": [
    {
      "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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"
}

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 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 bervolume tinggi dengan latensi rendah yang memerlukan penalaran, dan kasus penggunaan berbasis agen.

  • 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.

  • 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 canggih 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 mendalam, yang 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.

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).

grounding_tool_count GroundingToolCount  (opsional)

Jumlah alat perujukan.

Jumlah alat perataan tanah.

Kolom

type enum (string)  (opsional)

Jenis alat perujukan yang terkait dengan jumlah.

Nilai yang mungkin:

  • google_search
  • google_maps
  • retrieval
count integer  (opsional)

Jumlah alat perataan tanah.

response_modalities ResponseModality  (opsional)

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

Nilai yang mungkin:

  • text
  • image
  • audio
  • video
  • document

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 ServiceTier  (opsional)

Tingkat layanan untuk interaksi.

Nilai yang mungkin:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (opsional)

Opsional. Konfigurasi webhook untuk menerima notifikasi saat interaksi selesai.

Pesan untuk mengonfigurasi peristiwa webhook untuk permintaan.

Kolom

uris array (string)  (opsional)

Opsional. Jika ditetapkan, URI webhook ini akan digunakan untuk peristiwa webhook, bukan webhook yang terdaftar.

user_metadata object  (opsional)

Opsional. Metadata pengguna yang akan ditampilkan pada setiap pengiriman peristiwa ke webhook.

steps Step  (opsional)

Hanya output. Langkah-langkah yang membentuk interaksi.

Langkah dalam interaksi.

Kemungkinan Jenis

Diskriminator polimorfik: type

UserInputStep

Input yang diberikan oleh pengguna.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "user_input".

content array (Content)  (opsional)

Tidak tersedia deskripsi.

ModelOutputStep

Output yang dihasilkan oleh model.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "model_output".

content array (Content)  (opsional)

Tidak tersedia deskripsi.

ThoughtStep

Langkah pemikiran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought".

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

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 buatan model.

Informasi kutipan untuk konten buatan 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.

custom_metadata object  (opsional)

Metadata yang disediakan pengguna tentang konteks yang diambil.

page_number integer  (opsional)

Nomor halaman dokumen yang dikutip, jika ada.

media_id string  (opsional)

ID media dalam kasus kutipan gambar, jika ada.

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

FunctionCallStep

Langkah 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.

CodeExecutionCallStep

Langkah panggilan eksekusi kode.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_call".

arguments CodeExecutionCallStepArguments  (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.

UrlContextCallStep

Langkah panggilan konteks URL.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_call".

arguments UrlContextCallStepArguments  (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.

McpServerToolCallStep

Langkah 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.

GoogleSearchCallStep

Langkah panggilan Google Penelusuran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_call".

arguments GoogleSearchCallStepArguments  (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.

FileSearchCallStep

Langkah panggilan 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.

GoogleMapsCallStep

Langkah panggilan Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_call".

arguments GoogleMapsCallStepArguments  (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.

FunctionResultStep

Hasil panggilan 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.

CodeExecutionResultStep

Langkah 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.

UrlContextResultStep

Langkah hasil konteks URL.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_result".

result UrlContextResultItem  (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.

GoogleSearchResultStep

Langkah hasil Google Penelusuran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_result".

result GoogleSearchResultItem  (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.

McpServerToolResultStep

Langkah hasil fitur 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.

FileSearchResultStep

Langkah hasil Penelusuran File.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_result".

call_id string  (wajib)

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

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsResultStep

Langkah hasil Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_result".

result GoogleMapsResultItem  (wajib)

Tidak tersedia deskripsi.

Hasil Google Maps.

Kolom

places GoogleMapsResultPlaces  (opsional)

Tidak tersedia deskripsi.

Kolom

place_id string  (opsional)

Tidak tersedia deskripsi.

name string  (opsional)

Tidak tersedia deskripsi.

url string  (opsional)

Tidak tersedia deskripsi.

review_snippets ReviewSnippet  (opsional)

Tidak tersedia deskripsi.

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)

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.

input Content atau array (Content) atau array (Step) atau string  (opsional)

Input untuk interaksi.

response_format ResponseFormat atau ResponseFormatList  (opsional)

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

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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?"
        }
      ]
    }
  ],
  "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 buatan model.

Informasi kutipan untuk konten buatan 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.

custom_metadata object  (opsional)

Metadata yang disediakan pengguna tentang konteks yang diambil.

page_number integer  (opsional)

Nomor halaman dokumen yang dikutip, jika ada.

media_id string  (opsional)

ID media dalam kasus kutipan gambar, jika ada.

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
channels integer  (opsional)

Jumlah saluran audio.

sample_rate integer  (opsional)

Frekuensi sampel 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

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

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
excluded_predefined_functions 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.

InteractionSseEvent

Kemungkinan Jenis

Diskriminator polimorfik: event_type

InteractionCreatedEvent

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "interaction.created".

interaksi Interaksi  (wajib diisi)

Tidak tersedia deskripsi.

event_id string  (opsional)

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

InteractionCompletedEvent

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "interaction.completed".

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.

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.

StepStart

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "step.start".

index integer  (wajib ada)

Tidak tersedia deskripsi.

step Step  (wajib)

Tidak tersedia deskripsi.

Langkah dalam interaksi.

Kemungkinan Jenis

Diskriminator polimorfik: type

UserInputStep

Input yang diberikan oleh pengguna.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "user_input".

content array (Content)  (opsional)

Tidak tersedia deskripsi.

ModelOutputStep

Output yang dihasilkan oleh model.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "model_output".

content array (Content)  (opsional)

Tidak tersedia deskripsi.

ThoughtStep

Langkah pemikiran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "thought".

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

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 buatan model.

Informasi kutipan untuk konten buatan 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.

custom_metadata object  (opsional)

Metadata yang disediakan pengguna tentang konteks yang diambil.

page_number integer  (opsional)

Nomor halaman dokumen yang dikutip, jika ada.

media_id string  (opsional)

ID media dalam kasus kutipan gambar, jika ada.

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

FunctionCallStep

Langkah 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.

CodeExecutionCallStep

Langkah panggilan eksekusi kode.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "code_execution_call".

arguments CodeExecutionCallStepArguments  (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.

UrlContextCallStep

Langkah panggilan konteks URL.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_call".

arguments UrlContextCallStepArguments  (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.

McpServerToolCallStep

Langkah 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.

GoogleSearchCallStep

Langkah panggilan Google Penelusuran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_call".

arguments GoogleSearchCallStepArguments  (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.

FileSearchCallStep

Langkah panggilan 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.

GoogleMapsCallStep

Langkah panggilan Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_call".

arguments GoogleMapsCallStepArguments  (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.

FunctionResultStep

Hasil panggilan 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.

CodeExecutionResultStep

Langkah 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.

UrlContextResultStep

Langkah hasil konteks URL.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "url_context_result".

result UrlContextResultItem  (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.

GoogleSearchResultStep

Langkah hasil Google Penelusuran.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_search_result".

result GoogleSearchResultItem  (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.

McpServerToolResultStep

Langkah hasil fitur 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.

FileSearchResultStep

Langkah hasil Penelusuran File.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "file_search_result".

call_id string  (wajib)

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

signature string  (opsional)

Hash tanda tangan untuk validasi backend.

GoogleMapsResultStep

Langkah hasil Google Maps.

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "google_maps_result".

result GoogleMapsResultItem  (wajib)

Tidak tersedia deskripsi.

Hasil Google Maps.

Kolom

places GoogleMapsResultPlaces  (opsional)

Tidak tersedia deskripsi.

Kolom

place_id string  (opsional)

Tidak tersedia deskripsi.

name string  (opsional)

Tidak tersedia deskripsi.

url string  (opsional)

Tidak tersedia deskripsi.

review_snippets ReviewSnippet  (opsional)

Tidak tersedia deskripsi.

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)

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.

event_id string  (opsional)

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

StepDelta

event_type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "step.delta".

index integer  (wajib ada)

Tidak tersedia deskripsi.

delta StepDeltaData  (wajib)

Tidak tersedia deskripsi.

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)

Tidak digunakan lagi. Gunakan sample_rate sebagai gantinya. Nilai diabaikan.

sample_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 buatan model.

Informasi kutipan untuk konten buatan 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.

custom_metadata object  (opsional)

Metadata yang disediakan pengguna tentang konteks yang diambil.

page_number integer  (opsional)

Nomor halaman dokumen yang dikutip, jika ada.

media_id string  (opsional)

ID media dalam kasus kutipan gambar, jika ada.

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.

TextAnnotationDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "text_annotation_delta".

annotations Annotation  (opsional)

Informasi kutipan untuk konten buatan model.

Informasi kutipan untuk konten buatan 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.

custom_metadata object  (opsional)

Metadata yang disediakan pengguna tentang konteks yang diambil.

page_number integer  (opsional)

Nomor halaman dokumen yang dikutip, jika ada.

media_id string  (opsional)

ID media dalam kasus kutipan gambar, jika ada.

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.

ArgumentsDelta

type object  (wajib)

Tidak tersedia deskripsi.

Selalu ditetapkan ke "arguments_delta".

partial_arguments string  (opsional)

Tidak tersedia deskripsi.

event_id string  (opsional)

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

StepStop

event_type object  (wajib)

Tidak tersedia deskripsi.

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

Contoh

Interaksi Dibuat

{
  "event_type": "interaction.created",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "in_progress",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

Interaksi Selesai

{
  "event_type": "interaction.completed",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "completed",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

Pembaruan Status Interaksi

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

Peristiwa Error

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

Mulai Langkah

{
  "event_type": "step.start",
  "index": 0,
  "step": {
    "type": "model_output"
  }
}

Delta Langkah

{
  "event_type": "step.delta",
  "index": 0,
  "delta": {
    "type": "text",
    "text": "Hello"
  }
}

Step Stop

{
  "event_type": "step.stop",
  "index": 0
}