Gemini API

API-ja Gemini Interactions është një API eksperimentale që u lejon zhvilluesve të ndërtojnë aplikacione gjeneruese të IA-së duke përdorur modelet Gemini. Gemini është modeli ynë më i aftë, i ndërtuar nga themeli për të qenë multimodal. Mund të përgjithësojë dhe të kuptojë, të funksionojë dhe të kombinojë pa probleme lloje të ndryshme informacioni, duke përfshirë gjuhën, imazhet, audion, videon dhe kodin. Ju mund ta përdorni API-në Gemini për raste përdorimi si arsyetimi nëpër tekst dhe imazhe, gjenerimi i përmbajtjes, agjentët e dialogut, sistemet e përmbledhjes dhe klasifikimit dhe më shumë.

Shiko si ulje Shikoni Specifikimin OpenAPI

Krijimi i një ndërveprimi

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

Krijon një ndërveprim të ri.

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

modeli ModelOpsioni (opsional)

Emri i `Modelit` të përdorur për gjenerimin e ndërveprimit.
E detyrueshme nëse `agjent` nuk është dhënë.

Vlerat e mundshme:

  • gemini-2.5-computer-use-preview-10-2025

    Një model i aftësive agjentike i projektuar për bashkëveprim të drejtpërdrejtë të ndërfaqes, duke i lejuar Gemini-t të perceptojë dhe të lundrojë në mjedise dixhitale.

  • gemini-2.5-flash

    Modeli ynë i parë hibrid i arsyetimit i cili mbështet një dritare konteksti prej 1M token dhe ka buxhete të të menduarit.

  • gemini-2.5-flash-image

    Modeli ynë i gjenerimit të imazheve vendase, i optimizuar për shpejtësi, fleksibilitet dhe kuptim kontekstual. Futja dhe dalja e tekstit ka të njëjtin çmim si në Flash 2.5.

  • gemini-2.5-flash-lite

    Modeli ynë më i vogël dhe më ekonomik, i ndërtuar për përdorim në shkallë të gjerë.

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

    Modeli më i fundit i bazuar në Gemini 2.5 Flash lite i optimizuar për efikasitet në kosto, rendiment të lartë dhe cilësi të lartë.

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

    Modelet tona audio vendase janë optimizuar për dalje audio me cilësi më të lartë me ritëm, natyrshmëri zëri, fjalëshmëri dhe humor më të mirë.

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

    Modeli më i fundit i bazuar në modelin 2.5 Flash. 2.5 Flash Preview është më i miri për përpunim në shkallë të gjerë, detyra me vonesë të ulët, me vëllim të lartë që kërkojnë të menduarit dhe raste përdorimi agjentësh.

  • gemini-2.5-flash-preview-tts

    Modeli ynë 2.5 Flash i konvertimit tekst-në-fjalë është optimizuar për gjenerim të fuqishëm të të folurit dhe të kontrollueshëm me vonesë të ulët.

  • gemini-2.5-pro

    Modeli ynë shumëfunksional i teknologjisë së fundit, i cili shkëlqen në kodim dhe detyra komplekse arsyetimi.

  • gemini-2.5-pro-preview-tts

    Modeli ynë audio 2.5 Pro i konvertimit tekst-në-fjalë është i optimizuar për gjenerim të fuqishëm të të folurit me vonesë të ulët për rezultate më natyrale dhe udhëzime më të lehta për t'u drejtuar.

  • gemini-3-flash-preview

    Modeli ynë më inteligjent i ndërtuar për shpejtësi, duke kombinuar inteligjencën kufitare me kërkimin dhe tokëzimin superior.

  • gemini-3-pro-image-preview

    Model i gjenerimit dhe redaktimit të imazheve sipas teknologjisë së fundit.

  • gemini-3-pro-preview

    Modeli ynë më inteligjent me arsyetim SOTA dhe kuptim multimodal, si dhe aftësi të fuqishme kodimi agjentik dhe vibrues.

  • gemini-3.1-pro-preview

    Modeli ynë më i fundit i arsyetimit SOTA me thellësi dhe nuancë të paparë, si dhe aftësi të fuqishme të të kuptuarit dhe kodimit multimodal.

  • gemini-3.1-flash-image-preview

    Inteligjencë vizuale e nivelit profesional me efikasitet me shpejtësinë e Flash-it dhe aftësi gjenerimi të bazuara në realitet.

  • gemini-3.1-flash-lite-preview

    Modeli ynë më me kosto efektive, i optimizuar për detyra agjentike me vëllim të lartë, përkthim dhe përpunim të thjeshtë të të dhënave.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Gjenerim i fuqishëm i të folurit me vonesë të ulët. Shijoni dalje natyrale, udhëzime të kontrollueshme dhe etiketa të reja audio ekspresive për kontroll të saktë të rrëfimit.

  • lyria-3-clip-preview

    Modeli ynë i gjenerimit të muzikës me latencë të ulët është i optimizuar për klipe audio me besnikëri të lartë dhe kontroll të saktë ritmik.

  • lyria-3-pro-preview

    Modeli ynë i avancuar, gjenerues i këngëve të plota, me kuptim të thellë kompozicioni, i optimizuar për kontroll të saktë strukturor dhe tranzicione komplekse nëpër stile të ndryshme muzikore.

Modeli që do të plotësojë kërkesën tuaj.\n\nShihni [models](https://ai.google.dev/gemini-api/docs/models) për detaje shtesë.

agjenti i agjentit (opsionale)

Emri i `Agjentit` të përdorur për gjenerimin e ndërveprimit.
E detyrueshme nëse `model` nuk është dhënë.

Vlerat e mundshme:

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

    Agjent i Kërkimeve të Thellë Gemini

  • deep-research-preview-04-2026

    Agjent i Kërkimeve të Thellë Gemini

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

    Agjenti Maksimal i Kërkimeve të Thellë Gemini

Agjenti me të cilin duhet të ndërveprohet.

input Content ose matricë ( Content ) ose matricë ( Turn ) ose varg (i detyrueshëm)

Të dhënat hyrëse për bashkëveprimin (të përbashkëta si për Modelin ashtu edhe për Agjentin).

vargu i udhëzimit_të_sistem-it (opsional)

Udhëzime sistemi për bashkëveprimin.

varg mjetesh ( Mjet ) (opsional)

Një listë e deklarimeve të mjeteve që modeli mund të thërrasë gjatë ndërveprimit.

objekti response_format (opsional)

Zbaton që përgjigjja e gjeneruar të jetë një objekt JSON që përputhet me skemën JSON të specifikuar në këtë fushë.

vargu i tipit të përgjigjes_mime (opsional)

Lloji mime i përgjigjes. Kjo kërkohet nëse është vendosur response_format.

vlera booleane e rrjedhës (opsionale)

Vetëm të dhëna. Nëse bashkëveprimi do të transmetohet.

ruaj vlerën booleane (opsionale)

Vetëm hyrje. Nëse përgjigja dhe kërkesa do të ruhen për rikthim të mëvonshëm.

boolean i sfondit (opsional)

Vetëm të dhëna. Nëse do të ekzekutohet bashkëveprimi i modelit në sfond.

generation_config GenerationConfig (opsionale)

Konfigurimi i modelit
Parametrat e konfigurimit për bashkëveprimin e modelit.
Alternativë ndaj `agent_config`. I zbatueshëm vetëm kur është vendosur `model`.

Parametrat e konfigurimit për ndërveprimet e modelit.

Fushat

numri i temperaturës (opsional)

Kontrollon rastësinë e rezultatit.

numri top_p (opsional)

Probabiliteti maksimal kumulativ i tokenëve që duhen marrë në konsideratë gjatë marrjes së mostrave.

numër i plotë fillestar (opsional)

Farë e përdorur në dekodim për riprodhueshmëri.

vargu stop_sequences (varg) (opsional)

Një listë e sekuencave të karaktereve që do të ndalojnë bashkëveprimin e daljes.

niveli_i_thinkingLevel_i_Thinking (opsionale )

Niveli i tokenëve të mendimit që modeli duhet të gjenerojë.

Vlerat e mundshme:

  • minimal
  • low
  • medium
  • high

thinking_summaries Përmbledhje të të Menduarit (opsionale)

Nëse do të përfshihen përmbledhje të mendimeve në përgjigje.

Vlerat e mundshme:

  • auto
  • none

numër i plotë max_output_tokens (opsional)

Numri maksimal i tokenëve që duhen përfshirë në përgjigje.

speech_config SpeechConfig (opsionale)

Konfigurimi për ndërveprimin me të folur.

Konfigurimi për ndërveprimin me të folur.

Fushat

varg zanor (opsional)

Zëri i folësit.

vargu i gjuhës (opsional)

Gjuha e të folurit.

varg altoparlanti (opsional)

Emri i folësit, duhet të përputhet me emrin e folësit të dhënë në kërkesë.

image_config ImageConfig (opsionale)

Konfigurimi për bashkëveprimin e imazhit.

Konfigurimi për bashkëveprimin e imazhit.

Fushat

numërimi i raportit_të_aspectit (varg) (opsional)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

  • 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
enumimi i madhësisë_së_imazhit (string) (opsional)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig ose ToolChoiceType (opsionale)

Konfigurimi i zgjedhjes së mjetit.

objekti agent_config (opsional)

Konfigurimi i Agjentit
Konfigurimi për agjentin.
Alternativë ndaj `generation_config`. I zbatueshëm vetëm kur është vendosur `agent`.

Llojet e mundshme

Diskriminuesi polimorfik: type

Konfigurimi i Agjentit Dinamike

Konfigurimi për agjentë dinamikë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "dynamic" .

DeepResearchAgentConfig

Konfigurimi për agjentin e Kërkimit të Thellë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur për "deep-research" .

thinking_summaries Përmbledhje të të Menduarit (opsionale)

Nëse do të përfshihen përmbledhje të mendimeve në përgjigje.

Vlerat e mundshme:

  • auto
  • none

numërimi i vizualizimit (varg) (opsional)

Nëse do të përfshihen vizualizime në përgjigje.

Vlerat e mundshme:

  • off
  • auto
boolean i planifikimit_bashkëpunues (opsional)

Aktivizon planifikimin njerëzor në ciklin e punës për agjentin e Kërkimit të Thellë. Nëse vendoset në "e vërtetë", agjenti i Kërkimit të Thellë do të ofrojë një plan kërkimi në përgjigjen e tij. Agjenti do të vazhdojë vetëm nëse përdoruesi e konfirmon planin në raundin tjetër.

vargu previous_interaction_id (opsional)

ID-ja e ndërveprimit të mëparshëm, nëse ka.

response_modalities ResponseModality (opsionale)

Modalitetet e kërkuara të përgjigjes (TEKSTI, IMAZHI, AUDIO).

Vlerat e mundshme:

  • text
  • image
  • audio
  • video
  • document

numërimi i nivelit_të_shërbimit (string) (opsional)

Niveli i shërbimit për bashkëveprimin.

Vlerat e mundshme:

  • flex
  • standard
  • priority

Përgjigje

Kthen një burim Ndërveprimi .

Kërkesë e thjeshtë

Shembull Përgjigjeje 

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

Shumëkthesë

Shembull Përgjigjeje 

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

Futja e imazhit

Shembull Përgjigjeje 

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

Thirrja e funksionit

Shembull Përgjigjeje 

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

Hulumtime të Thella

Shembull Përgjigjeje 

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

Duke marrë një ndërveprim

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

Merr detajet e plota të një bashkëveprimi të vetëm bazuar në `Interaction.id`-in e tij.

Parametrat e Shtegut / Pyetjes

vargu i identifikimit (i detyrueshëm)

Identifikuesi unik i ndërveprimit që do të rikuperohet.

vlera booleane e rrjedhës (opsionale)

Nëse vendoset në "e vërtetë", përmbajtja e gjeneruar do të transmetohet në mënyrë graduale.

Parazgjedhja është: False

vargu last_event_id (opsional)

Opsionale. Nëse vendoset, rifillon rrjedhën e ndërveprimit nga pjesa tjetër pas ngjarjes së shënuar nga ID-ja e ngjarjes. Mund të përdoret vetëm nëse `rrjedha` është e vërtetë.

include_input boolean (opsional)

Nëse vendoset në "e vërtetë", përfshin të dhënat hyrëse në përgjigje.

Parazgjedhja është: False

vargu api_version (opsional)

Cilin version të API-t të përdoret.

Përgjigje

Kthen një burim Ndërveprimi .

Merr Ndërveprimin

Shembull Përgjigjeje 

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

Fshirja e një ndërveprimi

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

Fshin ndërveprimin me anë të ID-së.

Parametrat e Shtegut / Pyetjes

vargu i identifikimit (i detyrueshëm)

Identifikuesi unik i ndërveprimit që do të fshihet.

vargu api_version (opsional)

Cilin version të API-t të përdoret.

Përgjigje

Nëse ka sukses, përgjigja është bosh.

Fshij Ndërveprimin

Anulimi i një ndërveprimi

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

Anulon një bashkëveprim me anë të ID-së. Kjo vlen vetëm për bashkëveprimet në sfond që janë ende në ekzekutim.

Parametrat e Shtegut / Pyetjes

vargu i identifikimit (i detyrueshëm)

Identifikuesi unik i ndërveprimit që do të anulohet.

vargu api_version (opsional)

Cilin version të API-t të përdoret.

Përgjigje

Kthen një burim Ndërveprimi .

Anulo Ndërveprimin

Shembull Përgjigjeje 

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

Burimet

Ndërveprimi

Burimi i Ndërveprimit.

Fushat

modeli ModelOpsioni (opsional)

Emri i `Modelit` të përdorur për gjenerimin e ndërveprimit.

Vlerat e mundshme:

  • gemini-2.5-computer-use-preview-10-2025

    Një model i aftësive agjentike i projektuar për bashkëveprim të drejtpërdrejtë të ndërfaqes, duke i lejuar Gemini-t të perceptojë dhe të lundrojë në mjedise dixhitale.

  • gemini-2.5-flash

    Modeli ynë i parë hibrid i arsyetimit i cili mbështet një dritare konteksti prej 1M token dhe ka buxhete të të menduarit.

  • gemini-2.5-flash-image

    Modeli ynë i gjenerimit të imazheve vendase, i optimizuar për shpejtësi, fleksibilitet dhe kuptim kontekstual. Futja dhe dalja e tekstit ka të njëjtin çmim si në Flash 2.5.

  • gemini-2.5-flash-lite

    Modeli ynë më i vogël dhe më ekonomik, i ndërtuar për përdorim në shkallë të gjerë.

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

    Modeli më i fundit i bazuar në Gemini 2.5 Flash lite i optimizuar për efikasitet në kosto, rendiment të lartë dhe cilësi të lartë.

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

    Modelet tona audio vendase janë optimizuar për dalje audio me cilësi më të lartë me ritëm, natyrshmëri zëri, fjalëshmëri dhe humor më të mirë.

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

    Modeli më i fundit i bazuar në modelin 2.5 Flash. 2.5 Flash Preview është më i miri për përpunim në shkallë të gjerë, detyra me vonesë të ulët, me vëllim të lartë që kërkojnë të menduarit dhe raste përdorimi agjentësh.

  • gemini-2.5-flash-preview-tts

    Modeli ynë 2.5 Flash i konvertimit tekst-në-fjalë është optimizuar për gjenerim të fuqishëm të të folurit dhe të kontrollueshëm me vonesë të ulët.

  • gemini-2.5-pro

    Modeli ynë shumëfunksional i teknologjisë së fundit, i cili shkëlqen në kodim dhe detyra komplekse arsyetimi.

  • gemini-2.5-pro-preview-tts

    Modeli ynë audio 2.5 Pro i konvertimit tekst-në-fjalë është i optimizuar për gjenerim të fuqishëm të të folurit me vonesë të ulët për rezultate më natyrale dhe udhëzime më të lehta për t'u drejtuar.

  • gemini-3-flash-preview

    Modeli ynë më inteligjent i ndërtuar për shpejtësi, duke kombinuar inteligjencën kufitare me kërkimin dhe tokëzimin superior.

  • gemini-3-pro-image-preview

    Model i gjenerimit dhe redaktimit të imazheve sipas teknologjisë së fundit.

  • gemini-3-pro-preview

    Modeli ynë më inteligjent me arsyetim SOTA dhe kuptim multimodal, si dhe aftësi të fuqishme kodimi agjentik dhe vibrues.

  • gemini-3.1-pro-preview

    Modeli ynë më i fundit i arsyetimit SOTA me thellësi dhe nuancë të paparë, si dhe aftësi të fuqishme të të kuptuarit dhe kodimit multimodal.

  • gemini-3.1-flash-image-preview

    Inteligjencë vizuale e nivelit profesional me efikasitet me shpejtësinë e Flash-it dhe aftësi gjenerimi të bazuara në realitet.

  • gemini-3.1-flash-lite-preview

    Modeli ynë më me kosto efektive, i optimizuar për detyra agjentike me vëllim të lartë, përkthim dhe përpunim të thjeshtë të të dhënave.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Gjenerim i fuqishëm i të folurit me vonesë të ulët. Shijoni dalje natyrale, udhëzime të kontrollueshme dhe etiketa të reja audio ekspresive për kontroll të saktë të rrëfimit.

  • lyria-3-clip-preview

    Modeli ynë i gjenerimit të muzikës me latencë të ulët është i optimizuar për klipe audio me besnikëri të lartë dhe kontroll të saktë ritmik.

  • lyria-3-pro-preview

    Modeli ynë i avancuar, gjenerues i këngëve të plota, me kuptim të thellë kompozicioni, i optimizuar për kontroll të saktë strukturor dhe tranzicione komplekse nëpër stile të ndryshme muzikore.

Modeli që do të plotësojë kërkesën tuaj.\n\nShihni [models](https://ai.google.dev/gemini-api/docs/models) për detaje shtesë.

agjenti i agjentit (opsionale)

Emri i `Agjentit` të përdorur për gjenerimin e ndërveprimit.

Vlerat e mundshme:

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

    Agjent i Kërkimeve të Thellë Gemini

  • deep-research-preview-04-2026

    Agjent i Kërkimeve të Thellë Gemini

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

    Agjenti Maksimal i Kërkimeve të Thellë Gemini

Agjenti me të cilin duhet të ndërveprohet.

vargu i identifikimit (opsional)

E detyrueshme. Vetëm rezultat. Një identifikues unik për përfundimin e ndërveprimit.

numërimi i statusit (varg) (opsional)

E detyrueshme. Vetëm rezultat. Statusi i ndërveprimit.

Vlerat e mundshme:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
varg i krijuar (opsional)

E detyrueshme. Vetëm rezultati. Ora në të cilën u krijua përgjigja në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

varg i përditësuar (opsional)

E detyrueshme. Vetëm rezultati. Ora në të cilën përgjigja është përditësuar për herë të fundit në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

varg roli (opsional)

Vetëm rezultati. Roli i ndërveprimit.

vargu i rezultateve ( Përmbajtja ) (opsionale)

Vetëm rezultate. Përgjigje nga modeli.

vargu i udhëzimit_të_sistem-it (opsional)

Udhëzime sistemi për bashkëveprimin.

varg mjetesh ( Mjet ) (opsional)

Një listë e deklarimeve të mjeteve që modeli mund të thërrasë gjatë ndërveprimit.

Përdorimi Përdorimi (opsional)

Vetëm rezultate. Statistikat mbi përdorimin e tokenit të kërkesës së ndërveprimit.

Statistikat mbi përdorimin e tokenit të kërkesës së ndërveprimit.

Fushat

total_input_tokens numër i plotë (opsional)

Numri i tokenëve në kërkesë (konteksti).

input_tokens_by_modality ModalityTokens (opsionale)

Një ndarje e përdorimit të tokenit të hyrjes sipas modalitetit.

Numërimi i tokenëve për një modalitet të vetëm përgjigjeje.

Fushat

modaliteti ResponseModality (opsionale)

Modaliteti i lidhur me numërimin e tokenëve.

Vlerat e mundshme:

  • text
  • image
  • audio
  • video
  • document

numër i plotë i tokenëve (opsionale)

Numri i tokenëve për modalitetin.

total_cached_tokens numër i plotë (opsional)

Numri i tokenëve në pjesën e ruajtur në memorien e përkohshme të kërkesës (përmbajtja e ruajtur në memorien e përkohshme).

cached_tokens_by_modality ModalityTokens (opsionale)

Një ndarje e përdorimit të tokenëve të ruajtur në memorje sipas modalitetit.

Numërimi i tokenëve për një modalitet të vetëm përgjigjeje.

Fushat

modaliteti ResponseModality (opsionale)

Modaliteti i lidhur me numërimin e tokenëve.

Vlerat e mundshme:

  • text
  • image
  • audio
  • video
  • document

numër i plotë i tokenëve (opsionale)

Numri i tokenëve për modalitetin.

total_output_tokens numër i plotë (opsional)

Numri total i tokenëve në të gjitha përgjigjet e gjeneruara.

output_tokens_by_modality ModalityTokens (opsionale)

Një ndarje e përdorimit të tokenit të daljes sipas modalitetit.

Numërimi i tokenëve për një modalitet të vetëm përgjigjeje.

Fushat

modaliteti ResponseModality (opsionale)

Modaliteti i lidhur me numërimin e tokenëve.

Vlerat e mundshme:

  • text
  • image
  • audio
  • video
  • document

numër i plotë i tokenëve (opsionale)

Numri i tokenëve për modalitetin.

total_tool_use_tokens numër i plotë (opsional)

Numri i tokenëve të pranishëm në kërkesën/kërkesat e përdorimit të mjetit.

tool_use_tokens_by_modality ModalityTokens (opsionale)

Një ndarje e përdorimit të tokenëve të përdorimit të mjeteve sipas modalitetit.

Numërimi i tokenëve për një modalitet të vetëm përgjigjeje.

Fushat

modaliteti ResponseModality (opsionale)

Modaliteti i lidhur me numërimin e tokenëve.

Vlerat e mundshme:

  • text
  • image
  • audio
  • video
  • document

numër i plotë i tokenëve (opsionale)

Numri i tokenëve për modalitetin.

total_thought_tokens numër i plotë (opsional)

Numri i tokenëve të mendimeve për modelet e të menduarit.

total_tokens numër i plotë (opsional)

Numri total i tokenëve për kërkesën e ndërveprimit (kërkesa + përgjigjet + tokenët e tjerë të brendshëm).

response_modalities ResponseModality (opsionale)

Modalitetet e kërkuara të përgjigjes (TEKSTI, IMAZHI, AUDIO).

Vlerat e mundshme:

  • text
  • image
  • audio
  • video
  • document

objekti response_format (opsional)

Zbaton që përgjigjja e gjeneruar të jetë një objekt JSON që përputhet me skemën JSON të specifikuar në këtë fushë.

vargu i tipit të përgjigjes_mime (opsional)

Lloji mime i përgjigjes. Kjo kërkohet nëse është vendosur response_format.

vargu previous_interaction_id (opsional)

ID-ja e ndërveprimit të mëparshëm, nëse ka.

numërimi i nivelit_të_shërbimit (string) (opsional)

Niveli i shërbimit për bashkëveprimin.

Vlerat e mundshme:

  • flex
  • standard
  • priority
fut Përmbajtje ose varg ( Content ) ose varg ( Turn ) ose varg (opsional)

Të dhënat hyrëse për bashkëveprimin.

objekti agent_config (opsional)

Parametrat e konfigurimit për bashkëveprimin e agjentit.

Llojet e mundshme

Diskriminuesi polimorfik: type

Konfigurimi i Agjentit Dinamike

Konfigurimi për agjentë dinamikë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "dynamic" .

DeepResearchAgentConfig

Konfigurimi për agjentin e Kërkimit të Thellë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur për "deep-research" .

thinking_summaries Përmbledhje të të Menduarit (opsionale)

Nëse do të përfshihen përmbledhje të mendimeve në përgjigje.

Vlerat e mundshme:

  • auto
  • none

numërimi i vizualizimit (varg) (opsional)

Nëse do të përfshihen vizualizime në përgjigje.

Vlerat e mundshme:

  • off
  • auto
boolean i planifikimit_bashkëpunues (opsional)

Aktivizon planifikimin njerëzor në ciklin e punës për agjentin e Kërkimit të Thellë. Nëse vendoset në "e vërtetë", agjenti i Kërkimit të Thellë do të ofrojë një plan kërkimi në përgjigjen e tij. Agjenti do të vazhdojë vetëm nëse përdoruesi e konfirmon planin në raundin tjetër.

Shembuj

Shembull 

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

Modelet e të dhënave

Përmbajtja

Përmbajtja e përgjigjes.

Llojet e mundshme

Diskriminuesi polimorfik: type

Përmbajtje Teksti

Një bllok përmbajtjeje teksti.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "text" .

varg teksti (i detyrueshëm)

E detyrueshme. Përmbajtja e tekstit.

shënime Shënim (opsional)

Informacion mbi citimin për përmbajtjen e gjeneruar nga modeli.

Informacion mbi citimin për përmbajtjen e gjeneruar nga modeli.

Llojet e mundshme

Diskriminuesi polimorfik: type

Citimi i Url-it

Një shënim citimi URL-je.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_citation" .

vargu i url- së (opsional)

URL-ja.

vargu i titullit (opsional)

Titulli i URL-së.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

FileCitation

Një shënim citimi i skedarit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_citation" .

vargu document_uri (opsional)

URI-ja e skedarit.

vargu i emrit të skedarit (opsional)

Emri i skedarit.

vargu burimor (opsional)

Burimi i atribuuar për një pjesë të tekstit.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

Citimi i Vendit

Një shënim citimi vendi.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "place_citation" .

vargu place_id (opsional)

ID-ja e vendit, në formatin `places/{place_id}`.

varg emri (opsional)

Titulli i vendit.

vargu i url- së (opsional)

Referenca URI e vendit.

review_snippets ReviewSnippet (opsionale)

Fragmente të vlerësimeve që përdoren për të gjeneruar përgjigje rreth karakteristikave të një vendi të caktuar në Google Maps.

Përmban një fragment të një vlerësimi përdoruesi që përgjigjet një pyetjeje në lidhje me veçoritë e një vendi specifik në Google Maps.

Fushat

vargu i titullit (opsional)

Titulli i rishikimit.

vargu i url- së (opsional)

Një lidhje që korrespondon me vlerësimin e përdoruesit në Google Maps.

vargu review_id (opsional)

ID-ja e fragmentit të rishikimit.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "image" .

varg të dhënash (opsionale)

Përmbajtja e imazhit.

vargu uri (opsional)

URI-ja e imazhit.

mime_type enum (string) (opsionale)

Lloji i mimikës së imazhit.

Vlerat e mundshme:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high
  • ultra_high

Përmbajtje Audio

Një bllok përmbajtjeje audio.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "audio" .

varg të dhënash (opsionale)

Përmbajtja audio.

vargu uri (opsional)

URI-ja e audios.

mime_type enum (string) (opsionale)

Lloji i mimikës i audios.

Vlerat e mundshme:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
numër i plotë i normës (opsionale)

Shpejtësia e mostrës së audios.

numër i plotë i kanaleve (opsionale)

Numri i kanaleve audio.

Përmbajtja e Dokumentit

Një bllok përmbajtjeje dokumenti.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "document" .

varg të dhënash (opsionale)

Përmbajtja e dokumentit.

vargu uri (opsional)

URI-ja e dokumentit.

mime_type enum (string) (opsionale)

Lloji mime i dokumentit.

Vlerat e mundshme:

  • application/pdf
Përmbajtje Video

Një bllok përmbajtjeje video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "video" .

varg të dhënash (opsionale)

Përmbajtja e videos.

vargu uri (opsional)

URI-ja e videos.

mime_type enum (string) (opsionale)

Lloji i mimikës së videos.

Vlerat e mundshme:

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

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high
  • ultra_high

Përmbajtje Mendimi

Një bllok përmbajtjeje të mendimit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "thought" .

varg nënshkrimi (opsional)

Nënshkrimi që përputhet me burimin e backend-it për të qenë pjesë e gjenerimit.

përmbledhje ThoughtSummaryContent (opsionale)

Një përmbledhje e mendimit.

Llojet e mundshme

Diskriminuesi polimorfik: type

Përmbajtje Teksti

Një bllok përmbajtjeje teksti.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "text" .

varg teksti (i detyrueshëm)

E detyrueshme. Përmbajtja e tekstit.

shënime Shënim (opsional)

Informacion mbi citimin për përmbajtjen e gjeneruar nga modeli.

Informacion mbi citimin për përmbajtjen e gjeneruar nga modeli.

Llojet e mundshme

Diskriminuesi polimorfik: type

Citimi i Url-it

Një shënim citimi URL-je.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_citation" .

vargu i url- së (opsional)

URL-ja.

vargu i titullit (opsional)

Titulli i URL-së.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

FileCitation

Një shënim citimi i skedarit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_citation" .

vargu document_uri (opsional)

URI-ja e skedarit.

vargu i emrit të skedarit (opsional)

Emri i skedarit.

vargu burimor (opsional)

Burimi i atribuuar për një pjesë të tekstit.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

Citimi i Vendit

Një shënim citimi vendi.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "place_citation" .

vargu place_id (opsional)

ID-ja e vendit, në formatin `places/{place_id}`.

varg emri (opsional)

Titulli i vendit.

vargu i url- së (opsional)

Referenca URI e vendit.

review_snippets ReviewSnippet (opsionale)

Fragmente të vlerësimeve që përdoren për të gjeneruar përgjigje rreth karakteristikave të një vendi të caktuar në Google Maps.

Përmban një fragment të një vlerësimi përdoruesi që përgjigjet një pyetjeje në lidhje me veçoritë e një vendi specifik në Google Maps.

Fushat

vargu i titullit (opsional)

Titulli i rishikimit.

vargu i url- së (opsional)

Një lidhje që korrespondon me vlerësimin e përdoruesit në Google Maps.

vargu review_id (opsional)

ID-ja e fragmentit të rishikimit.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "image" .

varg të dhënash (opsionale)

Përmbajtja e imazhit.

vargu uri (opsional)

URI-ja e imazhit.

mime_type enum (string) (opsionale)

Lloji i mimikës së imazhit.

Vlerat e mundshme:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high
  • ultra_high

FunctionCallContent

Një bllok përmbajtjeje për thirrjen e mjetit të funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function_call" .

varg emri (i detyrueshëm)

E detyrueshme. Emri i mjetit që do të thirret.

argumente objekt (i detyrueshëm)

E detyrueshme. Argumentet që duhen kaluar te funksioni.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

CodeExecutionCallContent

Përmbajtja e ekzekutimit të kodit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution_call" .

argumentet CodeExecutionCallArguments (e detyrueshme)

E detyrueshme. Argumentet që do të kalohen në ekzekutimin e kodit.

Argumentet për t'i kaluar ekzekutimit të kodit.

Fushat

enumimi i gjuhës (string) (opsional)

Gjuha e programimit të `kodit`.

Vlerat e mundshme:

  • python
varg kodi (opsional)

Kodi që do të ekzekutohet.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

UrlContextCallContent

Përmbajtja e kontekstit të URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context_call" .

argumentet UrlContextCallArguments (e detyrueshme)

E detyrueshme. Argumentet që duhen kaluar në kontekstin e URL-së.

Argumentet që duhen kaluar në kontekstin e URL-së.

Fushat

vargu i URL -ve (string) (opsional)

URL-të që duhen marrë.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

McpServerToolCallContent

Përmbajtja e thirrjes së mjetit MCPServer.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server_tool_call" .

varg emri (i detyrueshëm)

E detyrueshme. Emri i mjetit që u thirr.

vargu i emrit të serverit (i detyrueshëm)

E detyrueshme. Emri i serverit MCP të përdorur.

argumente objekt (i detyrueshëm)

E detyrueshme. Objekti JSON i argumenteve për funksionin.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

Përmbajtja e Kërkimit në GoogleCall

Përmbajtja e Kërkimit në Google.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search_call" .

argumente GoogleSearchCallArgumente (e detyrueshme)

E detyrueshme. Argumentet që duhen kaluar te Kërkimi në Google.

Argumentet që duhen kaluar te Kërkimi në Google.

Fushat

varg pyetjesh (varg) (opsional)

Pyetje kërkimi në internet për kërkimin pasues në internet.

enumimi i tipit_të_kërkimit (string) (opsional)

Lloji i bazës së kërkimit të aktivizuar.

Vlerat e mundshme:

  • web_search
  • image_search
  • enterprise_web_search
vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

FileSearchCallContent

Përmbajtja e Kërkimit të Skedarëve.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_search_call" .

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

Përmbajtja e GoogleMapsCall

Përmbajtja e Hartave të Google.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_maps_call" .

argumentet GoogleMapsCallArguments (opsionale)

Argumentet për t'i kaluar mjetit Google Maps.

Argumentet për t'i kaluar mjetit Google Maps.

Fushat

varg pyetjesh (varg) (opsional)

Pyetjet që do të ekzekutohen.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

FunksioniResultContent

Një bllok përmbajtjeje rezultati i mjetit të funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function_result" .

varg emri (opsional)

Emri i mjetit që u thirr.

is_error boolean (opsionale)

Nëse thirrja e mjetit rezultoi në një gabim.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

varg rezultatesh ( FunctionResultSubcontent ) ose varg (i detyrueshëm)

Rezultati i thirrjes së mjetit.

Përmbajtja e Rezultatit të Ekzekutimit të Kodit

Përmbajtja e rezultatit të ekzekutimit të kodit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution_result" .

varg rezultati (i detyrueshëm)

E detyrueshme. Rezultati i ekzekutimit të kodit.

is_error boolean (opsionale)

Nëse ekzekutimi i kodit rezultoi në një gabim.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

UrlContextResultContent

Përmbajtja e rezultatit të kontekstit të URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context_result" .

rezultati UrlContextResult (i detyrueshëm)

E detyrueshme. Rezultatet e kontekstit të URL-së.

Rezultati i kontekstit të URL-së.

Fushat

vargu i url- së (opsional)

URL-ja që u mor.

numërimi i statusit (varg) (opsional)

Statusi i rikthimit të URL-së.

Vlerat e mundshme:

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

Nëse konteksti i URL-së rezultoi në një gabim.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

Përmbajtja e Rezultateve të Kërkimit në Google

Përmbajtja e rezultateve të Kërkimit në Google.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search_result" .

rezultati GoogleSearchResult (i detyrueshëm)

E detyrueshme. Rezultatet e Kërkimit në Google.

Rezultati i Kërkimit në Google.

Fushat

vargu i sugjerimeve të kërkimit (opsional)

Fragment përmbajtjeje uebi që mund të integrohet në një faqe uebi ose në një pamje uebi të aplikacionit.

is_error boolean (opsionale)

Nëse Kërkimi në Google rezultoi në një gabim.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

McpServerToolResultContent

Përmbajtja e rezultateve të mjetit MCPServer.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server_tool_result" .

varg emri (opsional)

Emri i mjetit që thirret për këtë thirrje specifike të mjetit.

vargu i emrit të serverit (opsional)

Emri i serverit MCP të përdorur.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

varg rezultatesh ( FunctionResultSubcontent ) ose varg (i detyrueshëm)

Dalja nga thirrja e serverit MCP. Mund të jetë tekst i thjeshtë ose përmbajtje e pasur.

Përmbajtja e Rezultateve të Kërkimit të Skedarëve

Përmbajtja e rezultatit të kërkimit të skedarëve.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_search_result" .

rezultati FileSearchResult (i detyrueshëm)

E detyrueshme. Rezultatet e Kërkimit të Skedarit.

Rezultati i Kërkimit të Skedarit.

Fushat

vargu custom_metadata (objekt) (opsional)

Përdoruesi dha meta të dhëna rreth FileSearchResult.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

Përmbajtja e Rezultateve të GoogleMaps

Përmbajtja e rezultateve të Google Maps.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_maps_result" .

rezultati GoogleMapsRezultati (i detyrueshëm)

E detyrueshme. Rezultatet e Google Maps.

Rezultati i Google Maps.

Fushat

vende Vende (opsionale)

Vendet që u gjetën.

Fushat

vargu place_id (opsional)

ID-ja e vendit, në formatin `places/{place_id}`.

varg emri (opsional)

Titulli i vendit.

vargu i url- së (opsional)

Referenca URI e vendit.

review_snippets ReviewSnippet (opsionale)

Fragmente të vlerësimeve që përdoren për të gjeneruar përgjigje rreth karakteristikave të një vendi të caktuar në Google Maps.

Përmban një fragment të një vlerësimi përdoruesi që përgjigjet një pyetjeje në lidhje me veçoritë e një vendi specifik në Google Maps.

Fushat

vargu i titullit (opsional)

Titulli i rishikimit.

vargu i url- së (opsional)

Një lidhje që korrespondon me vlerësimin e përdoruesit në Google Maps.

vargu review_id (opsional)

ID-ja e fragmentit të rishikimit.

vargu i shenjës së widget_context_token (opsional)

Emri i burimit të tokenit të kontekstit të vegëlve të Google Maps.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

Shembuj

Tekst 

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

Imazh 

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

Audio 

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

Dokument 

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

Video 

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

Mendim 

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

Thirrja e funksionit 

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

Thirrje për Ekzekutimin e Kodit 

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

Thirrje për Kontekstin e Url-së 

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

Thirrja e Mjetit të Serverit Mcp 

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

Thirrje për Kërkimin në Google 

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

Thirrje për Kërkimin e Skedarëve 

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

Thirrje në Google Maps 

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

Rezultati i funksionit 

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

Rezultati i Ekzekutimit të Kodit 

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

Rezultati i Kontekstit të URL-së 

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

Rezultati i Kërkimit në Google 

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

Rezultati i Mjetit të Serverit Mcp 

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

Rezultati i Kërkimit të Skedarëve 

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

Rezultati i Hartave Google 

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

Mjet

Një mjet që mund të përdoret nga modeli.

Llojet e mundshme

Diskriminuesi polimorfik: type

Funksioni

Një mjet që mund të përdoret nga modeli.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

varg emri (opsional)

Emri i funksionit.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

Konteksti i Url-it

A tool that can be used by the model to fetch URL context.

type object (required)

No description provided.

Always set to "url_context" .

ComputerUse

A tool that can be used by the model to interact with the computer.

type object (required)

No description provided.

Always set to "computer_use" .

environment enum (string) (optional)

The environment being operated.

Possible values:

  • browser
excludedPredefinedFunctions array (string) (optional)

The list of predefined functions that are excluded from the model call.

McpServer

A MCPServer is a server that can be called by the model to perform actions.

type object (required)

No description provided.

Always set to "mcp_server" .

name string (optional)

The name of the MCPServer.

url string (optional)

The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"

headers object (optional)

Optional: Fields for authentication headers, timeouts, etc., if needed.

allowed_tools AllowedTools (optional)

The allowed tools.

The configuration for allowed tools.

Fields

mode ToolChoiceType (optional)

The mode of the tool choice.

Possible values:

  • auto
  • any
  • none
  • validated

tools array (string) (optional)

The names of the allowed tools.

GoogleSearch

A tool that can be used by the model to search Google.

type object (required)

No description provided.

Always set to "google_search" .

search_types array (enum (string)) (optional)

The types of search grounding to enable.

Possible values:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

A tool that can be used by the model to search files.

type object (required)

No description provided.

Always set to "file_search" .

file_search_store_names array (string) (optional)

The file search store names to search.

top_k integer (optional)

The number of semantic retrieval chunks to retrieve.

metadata_filter string (optional)

Metadata filter to apply to the semantic retrieval documents and chunks.

GoogleMaps

A tool that can be used by the model to call Google Maps.

type object (required)

No description provided.

Always set to "google_maps" .

enable_widget boolean (optional)

Whether to return a widget context token in the tool call result of the response.

latitude number (optional)

The latitude of the user's location.

longitude number (optional)

The longitude of the user's location.

Retrieval

A tool that can be used by the model to retrieve files.

type object (required)

No description provided.

Always set to "retrieval" .

retrieval_types array (enum (string)) (optional)

The types of file retrieval to enable.

Possible values:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig (optional)

Used to specify configuration for VertexAISearch.

Used to specify configuration for VertexAISearch.

Fields

engine string (optional)

Optional. Used to specify Vertex AI Search engine.

datastores array (string) (optional)

Optional. Used to specify Vertex AI Search datastores.

Shembuj

Funksioni

CodeExecution

UrlContext

ComputerUse

McpServer

GoogleSearch

FileSearch

GoogleMaps

Retrieval

No examples available for this type.

Kthehu

Fields

role string (optional)

The originator of this turn. Must be user for input or model for model output.

content array ( Content ) or string (optional)

No description provided.

Shembuj

User Turn 

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

Model Turn 

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

InteractionSseEvent

Possible Types

Polymorphic discriminator: event_type

InteractionStartEvent

event_type object (required)

No description provided.

Always set to "interaction.start" .

interaction Interaction (required)

No description provided.

event_id string (optional)

The event_id token to be used to resume the interaction stream, from this event.

InteractionCompleteEvent

event_type object (required)

No description provided.

Always set to "interaction.complete" .

interaction Interaction (required)

Required. The completed interaction with empty outputs to reduce the payload size. Use the preceding ContentDelta events for the actual output.

event_id string (optional)

The event_id token to be used to resume the interaction stream, from this event.

InteractionStatusUpdate

event_type object (required)

No description provided.

Always set to "interaction.status_update" .

interaction_id string (required)

No description provided.

status enum (string) (required)

No description provided.

Possible values:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_id string (optional)

The event_id token to be used to resume the interaction stream, from this event.

ContentStart

event_type object (required)

No description provided.

Always set to "content.start" .

index integer (required)

No description provided.

content Content (required)

No description provided.

event_id string (optional)

The event_id token to be used to resume the interaction stream, from this event.

ContentDelta

event_type object (required)

No description provided.

Always set to "content.delta" .

index integer (required)

No description provided.

delta ContentDeltaData (required)

No description provided.

The delta content data for a content block.

Possible Types

Polymorphic discriminator: type

TextDelta

type object (required)

No description provided.

Always set to "text" .

text string (required)

No description provided.

ImageDelta

type object (required)

No description provided.

Always set to "image" .

data string (optional)

No description provided.

uri string (optional)

No description provided.

mime_type enum (string) (optional)

No description provided.

Possible values:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution (optional)

The resolution of the media.

Possible values:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object (required)

No description provided.

Always set to "audio" .

data string (optional)

No description provided.

uri string (optional)

No description provided.

mime_type enum (string) (optional)

No description provided.

Possible values:

  • 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 (optional)

The sample rate of the audio.

channels integer (optional)

The number of audio channels.

DocumentDelta

type object (required)

No description provided.

Always set to "document" .

data string (optional)

No description provided.

uri string (optional)

No description provided.

mime_type enum (string) (optional)

No description provided.

Possible values:

  • application/pdf
VideoDelta

type object (required)

No description provided.

Always set to "video" .

data string (optional)

No description provided.

uri string (optional)

No description provided.

mime_type enum (string) (optional)

No description provided.

Possible values:

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

The resolution of the media.

Possible values:

  • low
  • medium
  • high
  • ultra_high

ThoughtSummaryDelta

type object (required)

No description provided.

Always set to "thought_summary" .

content ThoughtSummaryContent (optional)

A new summary item to be added to the thought.

Possible Types

Polymorphic discriminator: type

TextContent

A text content block.

type object (required)

No description provided.

Always set to "text" .

text string (required)

Required. The text content.

annotations Annotation (optional)

Citation information for model-generated content.

Citation information for model-generated content.

Possible Types

Polymorphic discriminator: type

UrlCitation

A URL citation annotation.

type object (required)

No description provided.

Always set to "url_citation" .

url string (optional)

The URL.

title string (optional)

The title of the URL.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

end_index integer (optional)

End of the attributed segment, exclusive.

FileCitation

A file citation annotation.

type object (required)

No description provided.

Always set to "file_citation" .

document_uri string (optional)

The URI of the file.

file_name string (optional)

The name of the file.

source string (optional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

end_index integer (optional)

End of the attributed segment, exclusive.

PlaceCitation

A place citation annotation.

type object (required)

No description provided.

Always set to "place_citation" .

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

name string (optional)

Title of the place.

url string (optional)

URI reference of the place.

review_snippets ReviewSnippet (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.

Fields

title string (optional)

Title of the review.

url string (optional)

A link that corresponds to the user review on Google Maps.

review_id string (optional)

The ID of the review snippet.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

end_index integer (optional)

End of the attributed segment, exclusive.

ImageContent

An image content block.

type object (required)

No description provided.

Always set to "image" .

data string (optional)

The image content.

uri string (optional)

The URI of the image.

mime_type enum (string) (optional)

The mime type of the image.

Possible values:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution (optional)

The resolution of the media.

Possible values:

  • low
  • medium
  • high
  • ultra_high

ThoughtSignatureDelta

type object (required)

No description provided.

Always set to "thought_signature" .

signature string (optional)

Signature to match the backend source to be part of the generation.

FunctionCallDelta

type object (required)

No description provided.

Always set to "function_call" .

name string (required)

No description provided.

arguments object (required)

No description provided.

id string (required)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

CodeExecutionCallDelta

type object (required)

No description provided.

Always set to "code_execution_call" .

arguments CodeExecutionCallArguments (required)

No description provided.

The arguments to pass to the code execution.

Fields

language enum (string) (optional)

Programming language of the `code`.

Possible values:

  • python
code string (optional)

The code to be executed.

id string (required)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

UrlContextCallDelta

type object (required)

No description provided.

Always set to "url_context_call" .

arguments UrlContextCallArguments (required)

No description provided.

The arguments to pass to the URL context.

Fields

urls array (string) (optional)

The URLs to fetch.

id string (required)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

GoogleSearchCallDelta

type object (required)

No description provided.

Always set to "google_search_call" .

arguments GoogleSearchCallArguments (required)

No description provided.

The arguments to pass to Google Search.

Fields

queries array (string) (optional)

Web search queries for the following-up web search.

id string (required)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

McpServerToolCallDelta

type object (required)

No description provided.

Always set to "mcp_server_tool_call" .

name string (required)

No description provided.

server_name string (required)

No description provided.

arguments object (required)

No description provided.

id string (required)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

FileSearchCallDelta

type object (required)

No description provided.

Always set to "file_search_call" .

id string (required)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

GoogleMapsCallDelta

type object (required)

No description provided.

Always set to "google_maps_call" .

arguments GoogleMapsCallArguments (optional)

The arguments to pass to the Google Maps tool.

The arguments to pass to the Google Maps tool.

Fields

queries array (string) (optional)

The queries to be executed.

id string (required)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

FunctionResultDelta

type object (required)

No description provided.

Always set to "function_result" .

name string (optional)

No description provided.

is_error boolean (optional)

No description provided.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

result array ( FunctionResultSubcontent ) or string (required)

No description provided.

CodeExecutionResultDelta

type object (required)

No description provided.

Always set to "code_execution_result" .

result string (required)

No description provided.

is_error boolean (optional)

No description provided.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

UrlContextResultDelta

type object (required)

No description provided.

Always set to "url_context_result" .

result UrlContextResult (required)

No description provided.

The result of the URL context.

Fields

url string (optional)

The URL that was fetched.

status enum (string) (optional)

The status of the URL retrieval.

Possible values:

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

No description provided.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

GoogleSearchResultDelta

type object (required)

No description provided.

Always set to "google_search_result" .

result GoogleSearchResult (required)

No description provided.

The result of the Google Search.

Fields

search_suggestions string (optional)

Web content snippet that can be embedded in a web page or an app webview.

is_error boolean (optional)

No description provided.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

McpServerToolResultDelta

type object (required)

No description provided.

Always set to "mcp_server_tool_result" .

name string (optional)

No description provided.

server_name string (optional)

No description provided.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

result array ( FunctionResultSubcontent ) or string (required)

No description provided.

FileSearchResultDelta

type object (required)

No description provided.

Always set to "file_search_result" .

result FileSearchResult (required)

No description provided.

The result of the File Search.

Fields

custom_metadata array (object) (optional)

User provided metadata about the FileSearchResult.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

GoogleMapsResultDelta

type object (required)

No description provided.

Always set to "google_maps_result" .

result GoogleMapsResult (optional)

The results of the Google Maps.

The result of the Google Maps.

Fields

places Places (optional)

The places that were found.

Fields

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

name string (optional)

Title of the place.

url string (optional)

URI reference of the place.

review_snippets ReviewSnippet (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.

Fields

title string (optional)

Title of the review.

url string (optional)

A link that corresponds to the user review on Google Maps.

review_id string (optional)

The ID of the review snippet.

widget_context_token string (optional)

Resource name of the Google Maps widget context token.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

TextAnnotationDelta

type object (required)

No description provided.

Always set to "text_annotation" .

annotations Annotation (optional)

Citation information for model-generated content.

Citation information for model-generated content.

Possible Types

Polymorphic discriminator: type

UrlCitation

A URL citation annotation.

type object (required)

No description provided.

Always set to "url_citation" .

url string (optional)

The URL.

title string (optional)

The title of the URL.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

end_index integer (optional)

End of the attributed segment, exclusive.

FileCitation

A file citation annotation.

type object (required)

No description provided.

Always set to "file_citation" .

document_uri string (optional)

The URI of the file.

file_name string (optional)

The name of the file.

source string (optional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

end_index integer (optional)

End of the attributed segment, exclusive.

PlaceCitation

A place citation annotation.

type object (required)

No description provided.

Always set to "place_citation" .

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

name string (optional)

Title of the place.

url string (optional)

URI reference of the place.

review_snippets ReviewSnippet (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.

Fields

title string (optional)

Title of the review.

url string (optional)

A link that corresponds to the user review on Google Maps.

review_id string (optional)

The ID of the review snippet.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

end_index integer (optional)

End of the attributed segment, exclusive.

event_id string (optional)

The event_id token to be used to resume the interaction stream, from this event.

ContentStop

event_type object (required)

No description provided.

Always set to "content.stop" .

index integer (required)

No description provided.

event_id string (optional)

The event_id token to be used to resume the interaction stream, from this event.

ErrorEvent

event_type object (required)

No description provided.

Always set to "error" .

error Error (optional)

No description provided.

Error message from an interaction.

Fields

code string (optional)

A URI that identifies the error type.

message string (optional)

A human-readable error message.

event_id string (optional)

The event_id token to be used to resume the interaction stream, from this event.

Shembuj

Interaction Start 

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

Interaction Complete 

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

Interaction Status Update 

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

Content Start 

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

Content Delta 

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

Content Stop 

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

Error Event 

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