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

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

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)

Zgjedhja e mjetit për bashkëveprimin.

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

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

lloji i objektit (i detyrueshëm)

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

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

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

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

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

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

vargu i identifikimit (opsional)

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

numërimi i statusit (varg) (opsional)

Vetëm rezultati. Statusi i ndërveprimit.

Vlerat e mundshme:

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

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)

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

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

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

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

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

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.

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

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

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

lloji i objektit (i detyrueshëm)

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

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

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.

varg teksti (i detyrueshëm)

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.

vargu i url- së (opsional)

URL-ja.

vargu i titullit (opsional)

Titulli i URL-së.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "url_citation" .

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

FileCitation

Një shënim citimi i skedarit.

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.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "file_citation" .

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

Citimi i Vendit

Një shënim citimi vendi.

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.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "place_citation" .

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "text" .

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

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
rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high
  • ultra_high

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "image" .

Përmbajtje Audio

Një bllok përmbajtjeje 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
lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "audio" .

Përmbajtja e Dokumentit

Një bllok përmbajtjeje dokumenti.

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
lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "document" .

Përmbajtje Video

Një bllok përmbajtjeje 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

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "video" .

Përmbajtje Mendimi

Një bllok përmbajtjeje të mendimit.

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.

varg teksti (i detyrueshëm)

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.

vargu i url- së (opsional)

URL-ja.

vargu i titullit (opsional)

Titulli i URL-së.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "url_citation" .

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

FileCitation

Një shënim citimi i skedarit.

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.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "file_citation" .

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

Citimi i Vendit

Një shënim citimi vendi.

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.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "place_citation" .

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "text" .

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

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
rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high
  • ultra_high

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "image" .

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "thought" .

FunctionCallContent

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

varg emri (i detyrueshëm)

Emri i mjetit që do të thirret.

argumente objekt (i detyrueshëm)

Argumentet që duhen kaluar te funksioni.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "function_call" .

vargu i identifikimit (i detyrueshëm)

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.

varg emri (opsional)

Emri i mjetit që u thirr.

is_error boolean (opsionale)

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

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

Rezultati i thirrjes së mjetit.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "function_result" .

vargu call_id (i detyrueshëm)

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.

CodeExecutionCallContent

Përmbajtja e ekzekutimit të kodit.

argumentet CodeExecutionCallArguments (e detyrueshme)

Argumentet për t'i kaluar ekzekutimit të 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.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "code_execution_call" .

vargu i identifikimit (i detyrueshëm)

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 Rezultatit të Ekzekutimit të Kodit

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

varg rezultati (i detyrueshëm)

Rezultati i ekzekutimit të kodit.

is_error boolean (opsionale)

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

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "code_execution_result" .

vargu call_id (i detyrueshëm)

ID që përputhet me ID-në nga blloku i thirrjes së ekzekutimit të kodit.

varg nënshkrimi (opsional)

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

UrlContextCallContent

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

argumentet UrlContextCallArguments (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ë.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "url_context_call" .

vargu i identifikimit (i detyrueshëm)

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.

UrlContextResultContent

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

rezultati UrlContextResult (i detyrueshëm)

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.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "url_context_result" .

vargu call_id (i detyrueshëm)

ID që përputhet me ID-në nga blloku i thirrjes së kontekstit të url-së.

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.

argumente GoogleSearchCallArgumente (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
lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "google_search_call" .

vargu i identifikimit (i detyrueshëm)

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 Rezultateve të Kërkimit në Google

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

rezultati GoogleSearchResult (i detyrueshëm)

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.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "google_search_result" .

vargu call_id (i detyrueshëm)

ID që përputhet me ID-në nga blloku i thirrjeve të kërkimit në Google.

varg nënshkrimi (opsional)

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

McpServerToolCallContent

Përmbajtja e thirrjes së mjetit MCPServer.

varg emri (i detyrueshëm)

Emri i mjetit që u thirr.

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

Emri i serverit MCP të përdorur.

argumente objekt (i detyrueshëm)

Objekti JSON i argumenteve për funksionin.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "mcp_server_tool_call" .

vargu i identifikimit (i detyrueshëm)

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.

McpServerToolResultContent

Përmbajtja e rezultateve të mjetit MCPServer.

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.

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.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "mcp_server_tool_result" .

vargu call_id (i detyrueshëm)

ID që përputhet me ID-në nga blloku i thirrjes së mjetit të serverit MCP.

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)

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 Rezultateve të Kërkimit të Skedarëve

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

rezultati FileSearchResult (opsional)

Rezultatet e kërkimit të skedarëve.

Rezultati i Kërkimit të Skedarit.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "file_search_result" .

vargu call_id (i detyrueshëm)

ID që përputhet me ID-në nga blloku i thirrjes së kërkimit të skedarit.

varg nënshkrimi (opsional)

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

Përmbajtja e GoogleMapsCall

Përmbajtja e Hartave të Google.

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.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "google_maps_call" .

vargu i identifikimit (i detyrueshëm)

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 Rezultateve të GoogleMaps

Përmbajtja e rezultateve të Google Maps.

rezultati GoogleMapsRezultati (i detyrueshëm)

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.

lloji i objektit (i detyrueshëm)

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

Gjithmonë i vendosur në "google_maps_result" .

vargu call_id (i detyrueshëm)

ID që përputhet me ID-në nga blloku i thirrjeve të Google Maps.

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

Rezultati i funksionit 

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

Thirrje për Ekzekutimin e Kodit 

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

Rezultati i Ekzekutimit të Kodit 

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

Thirrje për Kontekstin e Url-së 

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

Rezultati i Kontekstit të URL-së 

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

Thirrje për Kërkimin në Google 

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

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

Thirrja e Mjetit të Serverit Mcp 

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

Rezultati i Mjetit të Serverit Mcp 

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

Thirrje për Kërkimin e Skedarëve 

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

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

Thirrje në Google Maps 

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

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

Llojet e mundshme

Diskriminuesi polimorfik: type

Funksioni

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

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.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "function" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

  • web_search
  • image_search
lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "google_search" .

Ekzekutimi i Kodit

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

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "code_execution" .

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "url_context" .

Përdorimi i Kompjuterit

Një mjet që mund të përdoret nga modeli për të bashkëvepruar me kompjuterin.

enum i mjedisit (string) (opsionale)

Mjedisi që operohet.

Vlerat e mundshme:

  • browser
varg (varg) i excludedPredefinedFunctions (opsional)

Lista e funksioneve të paracaktuara që përjashtohen nga thirrja e modelit.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "computer_use" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

varg emri (opsional)

Emri i MCPServer-it.

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

allowed_tools Mjetet e Lejuara (opsionale)

Mjetet e lejuara.

Konfigurimi për mjetet e lejuara.

Fushat

modaliteti ToolChoiceType (opsionale)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

  • auto
  • any
  • none
  • validated

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "mcp_server" .

Kërkimi i skedarëve

Një mjet që mund të përdoret nga modeli për të kërkuar skedarë.

vargu file_search_store_names (string) (opsional)

Kërkimi i skedarëve ruan emrat që duhen kërkuar.

numër i plotë top_k (opsional)

Numri i pjesëve të rikthimit semantik që duhen rikuperuar.

vargu i filtrit_të_metadata- ve (opsional)

Filtri i meta të dhënave për t'u aplikuar në dokumentet dhe pjesët e rikthimit semantik.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "file_search" .

GoogleMaps

Një mjet që mund të përdoret nga modeli për të thirrur Google Maps.

enable_widget boolean (opsionale)

Nëse duhet të kthehet një shenjë konteksti e widget-it në rezultatin e thirrjes së mjetit të përgjigjes.

numri i gjerësisë gjeografike (opsional)

Gjerësia gjeografike e vendndodhjes së përdoruesit.

numri i gjatësisë gjeografike (opsional)

Gjatësia gjeografike e vendndodhjes së përdoruesit.

lloji varg (opsional)

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

Gjithmonë i vendosur në "google_maps" .

Shembuj

Funksioni

Kërkimi në Google

Ekzekutimi i Kodit

Konteksti i Url-it

Përdorimi i Kompjuterit

McpServer

Kërkimi i skedarëve

GoogleMaps

Kthehu

Fushat

varg roli (opsional)

Origjinatori i kësaj kthese. Duhet të jetë përdoruesi për hyrje ose modeli për dalje të modelit.

vargu i përmbajtjes ( Përmbajtja ) ose vargu (opsional)

Përmbajtja e kthesës.

Shembuj

Kthesa e përdoruesit 

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

Kthesa e modelit 

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

Ngjarje NdërveprimiSse

Llojet e mundshme

Diskriminuesi polimorfik: event_type

Ngjarja e Fillimit të Ndërveprimit

ndërveprim Ndërveprim (i detyrueshëm)

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

enumimi i llojit_të_ngjarjes (string) (i detyrueshëm)

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

Vlerat e mundshme:

  • interaction.start
vargu i identifikimit_të_eventit (opsional)

Shenja event_id që do të përdoret për të rifilluar rrjedhën e ndërveprimit, nga kjo ngjarje.

Ngjarje e Përfunduar Ndërveprimi

ndërveprim Ndërveprim (i detyrueshëm)

Ndërveprimi i përfunduar me daljet boshe për të zvogëluar madhësinë e ngarkesës. Përdorni ngjarjet paraprake ContentDelta për daljen aktuale.

enumimi i llojit_të_ngjarjes (string) (i detyrueshëm)

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

Vlerat e mundshme:

  • interaction.complete
vargu i identifikimit_të_eventit (opsional)

Shenja event_id që do të përdoret për të rifilluar rrjedhën e ndërveprimit, nga kjo ngjarje.

Përditësimi i Statusit të Ndërveprimit

vargu interaction_id (i detyrueshëm)

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

numërimi i statusit (varg) (i detyrueshëm)

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

Vlerat e mundshme:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
vargu i llojit_të_ngjarjes (i detyrueshëm)

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

Gjithmonë i vendosur në "interaction.status_update" .

vargu i identifikimit_të_eventit (opsional)

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

ContentStart

index integer (required)

No description provided.

content Content (required)

No description provided.

event_type string (required)

No description provided.

Always set to "content.start" .

event_id string (optional)

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

ContentDelta

index integer (required)

No description provided.

delta object (required)

No description provided.

Possible Types

Polymorphic discriminator: type

TextDelta

text string (required)

No description provided.

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.

url string (optional)

The URL.

title string (optional)

The title of the URL.

type string (required)

No description provided.

Always set to "url_citation" .

start_index integer (optional)

Start of segment of the response that is attributed to this source.

end_index integer (optional)

End of the attributed segment, exclusive.

FileCitation

A file citation annotation.

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.

type string (required)

No description provided.

Always set to "file_citation" .

start_index integer (optional)

Start of segment of the response that is attributed to this source.

end_index integer (optional)

End of the attributed segment, exclusive.

PlaceCitation

A place citation annotation.

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.

Fushat

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.

type string (required)

No description provided.

Always set to "place_citation" .

start_index integer (optional)

Start of segment of the response that is attributed to this source.

end_index integer (optional)

End of the attributed segment, exclusive.

type object (required)

No description provided.

Always set to "text" .

ImageDelta

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
resolution MediaResolution (optional)

The resolution of the media.

Possible values:

  • low
  • medium
  • high
  • ultra_high

type object (required)

No description provided.

Always set to "image" .

AudioDelta

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
type object (required)

No description provided.

Always set to "audio" .

DocumentDelta

data string (optional)

No description provided.

uri string (optional)

No description provided.

mime_type enum (string) (optional)

No description provided.

Possible values:

  • application/pdf
type object (required)

No description provided.

Always set to "document" .

VideoDelta

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

type object (required)

No description provided.

Always set to "video" .

ThoughtSummaryDelta

content ThoughtSummaryContent (optional)

A new summary item to be added to the thought.

Possible Types

Polymorphic discriminator: type

TextContent

A text content block.

text string (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.

url string (optional)

The URL.

title string (optional)

The title of the URL.

type string (required)

No description provided.

Always set to "url_citation" .

start_index integer (optional)

Start of segment of the response that is attributed to this source.

end_index integer (optional)

End of the attributed segment, exclusive.

FileCitation

A file citation annotation.

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.

type string (required)

No description provided.

Always set to "file_citation" .

start_index integer (optional)

Start of segment of the response that is attributed to this source.

end_index integer (optional)

End of the attributed segment, exclusive.

PlaceCitation

A place citation annotation.

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.

Fushat

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.

type string (required)

No description provided.

Always set to "place_citation" .

start_index integer (optional)

Start of segment of the response that is attributed to this source.

end_index integer (optional)

End of the attributed segment, exclusive.

type object (required)

No description provided.

Always set to "text" .

ImageContent

An image content block.

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
resolution MediaResolution (optional)

The resolution of the media.

Possible values:

  • low
  • medium
  • high
  • ultra_high

type object (required)

No description provided.

Always set to "image" .

type object (required)

No description provided.

Always set to "thought_summary" .

ThoughtSignatureDelta

signature string (optional)

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

type object (required)

No description provided.

Always set to "thought_signature" .

FunctionCallDelta

name string (required)

No description provided.

arguments object (required)

No description provided.

type object (required)

No description provided.

Always set to "function_call" .

id string (required)

A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

FunctionResultDelta

name string (optional)

No description provided.

is_error boolean (optional)

No description provided.

result object or string (required)

Tool call result delta.

type object (required)

No description provided.

Always set to "function_result" .

call_id string (required)

ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

CodeExecutionCallDelta

arguments CodeExecutionCallArguments (required)

No description provided.

The arguments to pass to the code execution.

Fushat

language enum (string) (optional)

Programming language of the `code`.

Possible values:

  • python
code string (optional)

The code to be executed.

type object (required)

No description provided.

Always set to "code_execution_call" .

id string (required)

A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

CodeExecutionResultDelta

result string (required)

No description provided.

is_error boolean (optional)

No description provided.

type object (required)

No description provided.

Always set to "code_execution_result" .

call_id string (required)

ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

UrlContextCallDelta

arguments UrlContextCallArguments (required)

No description provided.

The arguments to pass to the URL context.

Fushat

urls array (string) (optional)

The URLs to fetch.

type object (required)

No description provided.

Always set to "url_context_call" .

id string (required)

A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

UrlContextResultDelta

result UrlContextResult (required)

No description provided.

The result of the URL context.

Fushat

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.

type object (required)

No description provided.

Always set to "url_context_result" .

call_id string (required)

ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

GoogleSearchCallDelta

arguments GoogleSearchCallArguments (required)

No description provided.

The arguments to pass to Google Search.

Fushat

queries array (string) (optional)

Web search queries for the following-up web search.

type object (required)

No description provided.

Always set to "google_search_call" .

id string (required)

A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

GoogleSearchResultDelta

result GoogleSearchResult (required)

No description provided.

The result of the Google Search.

Fushat

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.

type object (required)

No description provided.

Always set to "google_search_result" .

call_id string (required)

ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

McpServerToolCallDelta

name string (required)

No description provided.

server_name string (required)

No description provided.

arguments object (required)

No description provided.

type object (required)

No description provided.

Always set to "mcp_server_tool_call" .

id string (required)

A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

McpServerToolResultDelta

name string (optional)

No description provided.

server_name string (optional)

No description provided.

result object or string (required)

Tool call result delta.

type object (required)

No description provided.

Always set to "mcp_server_tool_result" .

call_id string (required)

ID to match the ID from the function call block.

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)

A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

FileSearchResultDelta

result FileSearchResult (optional)

No description provided.

The result of the File Search.

type object (required)

No description provided.

Always set to "file_search_result" .

call_id string (required)

ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

GoogleMapsCallDelta

arguments GoogleMapsCallArguments (optional)

The arguments to pass to the Google Maps tool.

The arguments to pass to the Google Maps tool.

Fushat

queries array (string) (optional)

The queries to be executed.

type object (required)

No description provided.

Always set to "google_maps_call" .

id string (required)

A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

GoogleMapsResultDelta

result GoogleMapsResult (required)

The results of the Google Maps.

The result of the Google Maps.

Fushat

places Places (optional)

The places that were found.

Fushat

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.

Fushat

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.

type object (required)

No description provided.

Always set to "google_maps_result" .

call_id string (required)

ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

event_type string (required)

No description provided.

Always set to "content.delta" .

event_id string (optional)

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

ContentStop

index integer (required)

No description provided.

event_type string (required)

No description provided.

Always set to "content.stop" .

event_id string (optional)

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

ErrorEvent

error Error (optional)

No description provided.

Error message from an interaction.

Fushat

code string (optional)

A URI that identifies the error type.

message string (optional)

A human-readable error message.

event_type string (required)

No description provided.

Always set to "error" .

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