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

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

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

  • 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-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-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-preview-native-audio-dialog

    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-image-preview

    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-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-pro-preview

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

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)

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.

tool_choice Zgjedhja e_ToolChoice (opsionale)

Zgjedhja e mjetit për bashkëveprimin.

Konfigurimi për zgjedhjen e mjetit.

Llojet e mundshme

Lloji i Zgjedhjes së Mjetit

Ky lloj nuk ka fusha specifike.

ToolChoiceConfig

allowed_tools Mjetet e Lejuara (opsionale)

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

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.

niveli_i_thinkingLevel_i_Thinking (opsionale )

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

Vlerat e mundshme:

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

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

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "dynamic" .

DeepResearchAgentConfig

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

lloji varg (opsional)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

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

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-2.5-flash",
  "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_reasoning_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

Shumëkthesë

Shembull Përgjigjeje

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "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_reasoning_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

Futja e imazhit

Shembull Përgjigjeje

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "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_reasoning_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

Thirrja e funksionit

Shembull Përgjigjeje

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "function_call": {
        "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_reasoning_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": "model",
  "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_reasoning_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ë.

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-2.5-flash",
  "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ë rikuperohet.

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

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

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

  • 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-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-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-preview-native-audio-dialog

    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-image-preview

    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-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-pro-preview

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

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

varg objekti (opsional)

Vetëm rezultati. Lloji i objektit të bashkëveprimit. Gjithmonë i vendosur në `bashkëveprim`.

Gjithmonë i vendosur në "interaction" .

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

vargu previous_interaction_id (opsional)

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

Shembuj

Shembull

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-2.5-flash",
  "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_reasoning_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 (opsional)

Përmbajtja e tekstit.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "text" .

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.

Fushat

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.

vargu burimor (opsional)

Burimi i atribuuar për një pjesë të tekstit. Mund të jetë një URL, titull ose identifikues tjetër.

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

mime_type ImageMimeTypeOpsioni (opsionale)

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

Vlerat e mundshme:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

Lloji i mimikës së imazhit.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "image" .

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high

Përmbajtje Audio

Një bllok përmbajtjeje audio.

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

mime_type AudioMimeTypeOpsioni (opsionale)

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

Vlerat e mundshme:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

Lloji i mimikës i audios.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "audio" .

Përmbajtja e Dokumentit

Një bllok përmbajtjeje dokumenti.

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

vargu mime_type (opsional)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "document" .

Përmbajtje Video

Një bllok përmbajtjeje video.

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

mime_type VideoMimeTypeOption (opsionale)

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

Vlerat e mundshme:

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

Lloji i mimikës së videos.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "video" .

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high

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.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "thought" .

përmbledhje ThoughtSummary (opsionale)

Një përmbledhje e mendimit.

Një përmbledhje e mendimit.

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

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "function_call" .

vargu i identifikimit (i detyrueshëm)

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

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.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "function_result" .

objekti ose vargu i rezultatit (i detyrueshëm)

Rezultati i thirrjes së mjetit.

vargu call_id (i detyrueshëm)

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

CodeExecutionCallContent

Përmbajtja e ekzekutimit të kodit.

argumentet CodeExecutionCallArguments (opsionale)

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

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "code_execution_call" .

vargu i identifikimit (opsional)

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

Përmbajtja e Rezultatit të Ekzekutimit të Kodit

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

varg rezultati (opsional)

Rezultati i ekzekutimit të kodit.

is_error boolean (opsionale)

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

varg nënshkrimi (opsional)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "code_execution_result" .

vargu call_id (opsional)

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

UrlContextCallContent

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

argumentet UrlContextCallArguments (opsionale)

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

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "url_context_call" .

vargu i identifikimit (opsional)

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

UrlContextResultContent

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

varg nënshkrimi (opsional)

Nënshkrimi i rezultatit të kontekstit të URL-së.

rezultati UrlContextResult (opsional)

Rezultatet e kontekstit të URL-së.

Rezultati i kontekstit të URL-së.

Fushat

vargu i url-(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 varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "url_context_result" .

vargu call_id (opsional)

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

Përmbajtja e Kërkimit në GoogleCall

Përmbajtja e Kërkimit në Google.

argumente GoogleSearchCallArguments (opsionale)

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.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "google_search_call" .

vargu i identifikimit (opsional)

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

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

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

varg nënshkrimi (opsional)

Nënshkrimi i rezultatit të Kërkimit në Google.

rezultati GoogleSearchResult (opsional)

Rezultatet e kërkimit në Google.

Rezultati i Kërkimit në Google.

Fushat

vargu i url-(opsional)

Referenca URI e rezultatit të kërkimit.

vargu i titullit (opsional)

Titulli i rezultatit të kërkimit.

vargu rendered_content (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 varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "google_search_result" .

vargu call_id (opsional)

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

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

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

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.

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.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "mcp_server_tool_result" .

objekti ose vargu i rezultatit (i detyrueshëm)

Rezultati i thirrjes së mjetit.

vargu call_id (i detyrueshëm)

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

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.

Fushat

vargu i titullit (opsional)

Titulli i rezultatit të kërkimit.

varg teksti (opsional)

Teksti i rezultatit të kërkimit.

vargu file_search_store (opsional)

Emri i dyqanit të kërkimit të skedarëve.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "file_search_result" .

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": {
    "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\n"
}

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

Rezultati i Kërkimit të Skedarëve

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

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.

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.

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "computer_use" .

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.

McpServer

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

lloji varg (i detyrueshëm)

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

Gjithmonë i vendosur në "mcp_server" .

varg emri (opsional)

Emri i MCPServer-it.

vargu i url-(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.

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

Shembuj

Funksioni

Kërkimi në Google

Ekzekutimi i Kodit

Konteksti i Url-it

Përdorimi i Kompjuterit

McpServer

Kërkimi i skedarëve

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

Ngjarje Ndërveprimi

enumimi i llojit_të_ngjarjes (string) (opsional)

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

Vlerat e mundshme:

  • interaction.start
  • interaction.complete
ndërveprim Ndërveprim (opsional)

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

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

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

numërimi i statusit (varg) (opsional)

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

Vlerat e mundshme:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
vargu i llojit_të_ngjarjes (opsional)

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

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

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.

Fillimi i Përmbajtjes

indeks numër i plotë (opsional)

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

Përmbajtja Përmbajtja (opsionale)

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

vargu i llojit_të_ngjarjes (opsional)

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

Gjithmonë i vendosur në "content.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.

ContentDelta

indeks numër i plotë (opsional)

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

vargu i llojit_të_ngjarjes (opsional)

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

Gjithmonë i vendosur në "content.delta" .

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.

objekt delta (opsional)

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

Llojet e mundshme

Diskriminuesi polimorfik: type

TextDelta

varg teksti (opsional)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "text" .

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.

Fushat

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.

vargu burimor (opsional)

Burimi i atribuuar për një pjesë të tekstit. Mund të jetë një URL, titull ose identifikues tjetër.

ImageDelta

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

mime_type ImageMimeTypeOpsioni (opsionale)

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

Vlerat e mundshme:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

Lloji i mimikës së imazhit.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "image" .

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high

AudioDelta

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

mime_type AudioMimeTypeOpsioni (opsionale)

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

Vlerat e mundshme:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

Lloji i mimikës i audios.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "audio" .

DocumentDelta

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

vargu mime_type (opsional)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "document" .

VideoDelta

varg të dhënash (opsionale)

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

vargu uri (opsional)

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

mime_type VideoMimeTypeOption (opsionale)

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

Vlerat e mundshme:

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

Lloji i mimikës së videos.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "video" .

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme:

  • low
  • medium
  • high

Përmbledhje e MendimitDelta

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "thought_summary" .

Përmbajtja ImageContent ose TextContent (opsionale)

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

ThoughtSignatureDelta

varg nënshkrimi (opsional)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "thought_signature" .

FunctionCallDelta

varg emri (opsional)

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

argumente objekt (opsionale)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "function_call" .

vargu i identifikimit (opsional)

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

FunctionResultDelta

varg emri (opsional)

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

is_error boolean (opsionale)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "function_result" .

objekt ose varg rezultati (opsional)

Delta e rezultatit të thirrjes së mjetit.

vargu call_id (opsional)

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

CodeExecutionCallDelta

argumentet CodeExecutionCallArguments (opsionale)

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

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

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "code_execution_call" .

vargu i identifikimit (opsional)

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

CodeExecutionResultDelta

varg rezultati (opsional)

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

is_error boolean (opsionale)

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

varg nënshkrimi (opsional)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "code_execution_result" .

vargu call_id (opsional)

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

UrlContextCallDelta

argumentet UrlContextCallArguments (opsionale)

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

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

Fushat

vargu i URL -ve (string) (opsional)

URL-të që duhen marrë.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "url_context_call" .

vargu i identifikimit (opsional)

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

UrlContextResultDelta

varg nënshkrimi (opsional)

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

rezultati UrlContextResult (opsional)

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

Rezultati i kontekstit të URL-së.

Fushat

vargu i url-(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)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "url_context_result" .

vargu call_id (opsional)

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

GoogleSearchCallDelta

argumente GoogleSearchCallArguments (opsionale)

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

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.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "google_search_call" .

vargu i identifikimit (opsional)

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

Rezultatet e Kërkimit në GoogleDelta

varg nënshkrimi (opsional)

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

rezultati GoogleSearchResult (opsional)

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

Rezultati i Kërkimit në Google.

Fushat

vargu i url-(opsional)

Referenca URI e rezultatit të kërkimit.

vargu i titullit (opsional)

Titulli i rezultatit të kërkimit.

vargu rendered_content (opsional)

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

is_error boolean (opsionale)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "google_search_result" .

vargu call_id (opsional)

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

McpServerToolCallDelta

varg emri (opsional)

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

vargu i emrit të serverit (opsional)

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

argumente objekt (opsionale)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "mcp_server_tool_call" .

vargu i identifikimit (opsional)

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

McpServerToolResultDelta

varg emri (opsional)

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

vargu i emrit të serverit (opsional)

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

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "mcp_server_tool_result" .

objekt ose varg rezultati (opsional)

Delta e rezultatit të thirrjes së mjetit.

vargu call_id (opsional)

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

FileSearchResultDelta

rezultati FileSearchResult (opsional)

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

Rezultati i Kërkimit të Skedarit.

Fushat

vargu i titullit (opsional)

Titulli i rezultatit të kërkimit.

varg teksti (opsional)

Teksti i rezultatit të kërkimit.

vargu file_search_store (opsional)

Emri i dyqanit të kërkimit të skedarëve.

lloji varg (i detyrueshëm)

Përdoret si diskriminues i tipit OpenAPI për përmbajtjen oneof.

Gjithmonë i vendosur në "file_search_result" .

ContentStop

indeks numër i plotë (opsional)

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

vargu i llojit_të_ngjarjes (opsional)

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

Gjithmonë i vendosur në "content.stop" .

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 Gabimi

vargu i llojit_të_ngjarjes (opsional)

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

Gjithmonë i vendosur në "error" .

gabim Gabim (opsional)

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

Mesazh gabimi nga një bashkëveprim.

Fushat

varg kodi (opsional)

Një URI që identifikon llojin e gabimit.

varg mesazhi (opsional)

Një mesazh gabimi i lexueshëm nga njeriu.

event_id string (optional)

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

Examples

Interaction Start

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

Interaction Complete

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-2.5-flash",
    "object": "interaction",
    "outputs": [
      {
        "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh",
        "type": "thought"
      },
      {
        "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",
        "type": "text"
      },
      {
        "text": " for one beloved anomaly: a chipped porcelain teacup, inherited from her grandmother, which held her morning Earl Grey.\n\nOne Tuesday, stirring her tea, Elara paused. At the bottom, nestled against the porcelain, was a star.",
        "type": "text"
      },
      {
        "text": " Not a star-shaped tea leaf, but a miniature, perfectly formed celestial body, radiating a faint, cool luminescence. Before she could gasp, it dissolved, leaving only the amber swirl of her brew. She dismissed it as a trick of",
        "type": "text"
      },
      {
        "text": " tired eyes.\n\nBut the next morning, a gossamer-thin feather, smaller than an eyelash and shimmering with iridescent hues, floated on the surface. It vanished the moment she tried to touch it. A week later, a single,",
        "type": "text"
      },
      {
        "text": " impossibly delicate bloom, like spun moonbeam, unfolded in her cup before fading into nothingness.\n\nThese weren't illusions. Each day, Elara\u2019s chipped teacup offered a fleeting, exquisite secret. A tiny, perfect",
        "type": "text"
      },
      {
        "text": " crystal, a miniature spiral nebula, a fragment of rainbow caught in liquid form. They never lingered, never accumulated, simply *were* and then *weren't*, leaving behind a residue of quiet wonder.\n\nElara never spoke",
        "type": "text"
      },
      {
        "text": " of it. It was her private wellspring, a daily reminder that magic could exist in the smallest, most overlooked corners of the world. Her routine remained unchanged, her external life a picture of calm, but inside, a secret garden blo",
        "type": "text"
      },
      {
        "text": "omed. Each dawn brought not just tea, but the silent promise of extraordinary beauty, waiting patiently in a chipped teacup.",
        "type": "text"
      }
    ],
    "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_reasoning_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

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

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