Gemini API

Gemini Interactions API, geliştiricilerin Gemini modellerini kullanarak üretken yapay zeka uygulamaları oluşturmasına olanak tanıyan deneysel bir API'dir. Gemini, baştan sona çok formatlı olacak şekilde tasarlanan en yetenekli modelimizdir. Dil, resim, ses, video ve kod gibi farklı bilgi türlerini genelleştirebilir, sorunsuz bir şekilde anlayabilir, bunlar üzerinde işlem yapabilir ve bunları birleştirebilir. Gemini API'yi metin ve resimler arasında akıl yürütme, içerik oluşturma, diyalog aracısı, özetleme ve sınıflandırma sistemleri gibi kullanım alanlarında kullanabilirsiniz.

Etkileşim oluşturma

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

Yeni bir etkileşim oluşturur.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

model ModelOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Model"in adı.
"agent" sağlanmadıysa zorunludur.

Olası değerler:

  • gemini-2.5-pro

    Kodlama ve karmaşık akıl yürütme görevlerinde üstün performans gösteren, en yeni çok amaçlı modelimiz.

  • gemini-2.5-flash

    1 milyon parçalık bağlam penceresini destekleyen ve düşünme bütçelerine sahip ilk karma akıl yürütme modelimiz.

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

    2.5 Flash modeline dayalı en yeni model. 2.5 Flash Preview, büyük ölçekli işleme, düşük gecikme süresi, düşünme gerektiren yüksek hacimli görevler ve temsilci kullanım alanları için en iyisidir.

  • gemini-2.5-flash-lite

    Büyük ölçekli kullanım için tasarlanan en küçük ve en uygun maliyetli modelimiz.

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

    Maliyet verimliliği, yüksek işleme hızı ve yüksek kalite için optimize edilmiş Gemini 2.5 Flash Lite'a dayalı en yeni model.

  • gemini-2.5-flash-preview-native-audio-dialog

    Daha iyi hız, ses doğallığı, ayrıntı ve ruh haliyle daha yüksek kaliteli ses çıkışları için optimize edilmiş yerel ses modellerimiz.

  • gemini-2.5-flash-image-preview

    Hız, esneklik ve bağlamsal anlayış için optimize edilmiş yerel görüntü üretme modelimiz. Metin girişi ve çıkışı, 2,5 Flash ile aynı şekilde fiyatlandırılır.

  • gemini-2.5-pro-preview-tts

    2.5 Pro metin okuma ses modelimiz, daha doğal çıkışlar ve daha kolay yönlendirilen istemler için güçlü ve düşük gecikmeli konuşma üretimi amacıyla optimize edilmiştir.

  • gemini-3-pro-preview

    En akıllı modelimiz; en gelişmiş akıl yürütme, çok formatlı anlama, güçlü aracı ve vibe kodlama özelliklerine sahiptir.

İsteminizi tamamlayacak model.\n\nEk ayrıntılar için [modeller](https://ai.google.dev/gemini-api/docs/models) bölümüne bakın.

agent AgentOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Agent"ın adı.
"model" sağlanmadıysa zorunludur.

Olası değerler:

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

    Gemini Deep Research Temsilcisi

Etkileşim kurulacak temsilci.

input Content veya dizi (Content) veya dizi (Turn) veya dize  (zorunlu)

Etkileşim için girişler (hem Model hem de Temsilci için ortaktır).

system_instruction string  (isteğe bağlı)

Etkileşim için sistem talimatı.

tools array (Tool)  (isteğe bağlı)

Modelin etkileşim sırasında çağırabileceği araç bildirimlerinin listesi.

response_format object  (isteğe bağlı)

Oluşturulan yanıtın, bu alanda belirtilen JSON şemasına uygun bir JSON nesnesi olmasını zorunlu kılar.

response_mime_type string  (isteğe bağlı)

Yanıtın MIME türü. response_format ayarlanmışsa bu parametre gereklidir.

stream boolean  (isteğe bağlı)

Yalnızca giriş. Etkileşimin yayınlanıp yayınlanmayacağı.

store boolean  (isteğe bağlı)

Yalnızca giriş. Yanıtın ve isteğin daha sonra alınmak üzere saklanıp saklanmayacağı.

background boolean  (isteğe bağlı)

Model etkileşiminin arka planda çalıştırılıp çalıştırılmayacağı.

generation_config GenerationConfig  (isteğe bağlı)

Model Yapılandırması
Model etkileşimi için yapılandırma parametreleri.
"agent_config" yerine kullanılabilir. Yalnızca "model" ayarlandığında geçerlidir.

Model etkileşimleri için yapılandırma parametreleri.

Alanlar

temperature number  (isteğe bağlı)

Çıkışın rastgeleliğini kontrol eder.

top_p number  (isteğe bağlı)

Örnekleme sırasında dikkate alınacak jetonların maksimum kümülatif olasılığı.

seed integer  (isteğe bağlı)

Yeniden üretilebilirlik için kod çözme işleminde kullanılan başlangıç değeri.

stop_sequences array (string)  (isteğe bağlı)

Çıkış etkileşimini durduracak karakter dizilerinin listesi.

tool_choice ToolChoice  (isteğe bağlı)

Etkileşim için kullanılan araç.

Araç seçimi için yapılandırma.

Olası Türler

ToolChoiceType

Bu türün belirli alanları yoktur.

ToolChoiceConfig

allowed_tools AllowedTools  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

İzin verilen araçların yapılandırması.

Alanlar

mode ToolChoiceType  (isteğe bağlı)

Araç seçiminin modu.

Olası değerler:

  • auto
  • any
  • none
  • validated

tools array (string)  (isteğe bağlı)

İzin verilen araçların adları.

thinking_level ThinkingLevel  (isteğe bağlı)

Modelin oluşturması gereken düşünce jetonlarının düzeyi.

Olası değerler:

  • low
  • high

thinking_summaries ThinkingSummaries  (isteğe bağlı)

Yanıtın düşünce özetlerini içerip içermeyeceği.

Olası değerler:

  • auto
  • none

max_output_tokens integer  (isteğe bağlı)

Yanıtın içereceği maksimum jeton sayısı.

speech_config SpeechConfig  (isteğe bağlı)

Konuşma etkileşimi için yapılandırma.

Konuşma etkileşimi yapılandırması.

Alanlar

voice string  (isteğe bağlı)

Konuşmacının sesi.

language string  (isteğe bağlı)

Konuşmanın dili.

speaker string  (isteğe bağlı)

Konuşmacının adı, istemde verilen konuşmacı adıyla eşleşmelidir.

agent_config object  (isteğe bağlı)

Aracı Yapılandırması
Aracının yapılandırması.
"generation_config" yerine kullanılabilir. Yalnızca "agent" ayarlandığında geçerlidir.

Olası Türler

Polimorfik ayrıştırıcı: type

DynamicAgentConfig

Dinamik aracılar için yapılandırma.

type string  (isteğe bağlı)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "dynamic" olarak ayarlanır.

DeepResearchAgentConfig

Deep Research temsilcisinin yapılandırması.

type string  (isteğe bağlı)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "deep-research" olarak ayarlanır.

thinking_summaries ThinkingSummaries  (isteğe bağlı)

Yanıtın düşünce özetlerini içerip içermeyeceği.

Olası değerler:

  • auto
  • none

previous_interaction_id string  (isteğe bağlı)

Önceki etkileşimin kimliği (varsa).

response_modalities ResponseModality  (isteğe bağlı)

Yanıtın istenen biçimleri (TEXT, IMAGE, AUDIO).

Olası değerler:

  • text
  • image
  • audio

Yanıt

Interaction kaynağını döndürür.

Basit İstek

Örnek Yanıt

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

Çok dönüşlü

Örnek Yanıt

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

Görüntü Girişi

Örnek Yanıt

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

İşlev Çağırma

Örnek Yanıt

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

Deep Research

Örnek Yanıt

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

Etkileşimi alma

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

Tek bir etkileşimin tüm ayrıntılarını `Interaction.id` değerine göre alır.

Yol / Sorgu Parametreleri

id dize  (zorunlu)

Alınacak etkileşimin benzersiz tanımlayıcısı.

stream boolean  (isteğe bağlı)

Doğru değerine ayarlanırsa oluşturulan içerik artımlı olarak yayınlanır.

Varsayılan değer: False

last_event_id dize  (isteğe bağlı)

İsteğe bağlıdır. Ayarlanırsa etkileşim akışını, etkinlik kimliğiyle işaretlenen etkinlikten sonraki parçadan devam ettirir. Yalnızca "stream" doğruysa kullanılabilir.

api_version dize  (isteğe bağlı)

API'nin hangi sürümünün kullanılacağı.

Yanıt

Interaction kaynağını döndürür.

Etkileşim Alma

Örnek Yanıt

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

Etkileşimi silme

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

Etkileşimi kimliğe göre siler.

Yol / Sorgu Parametreleri

id dize  (zorunlu)

Silinecek etkileşimin benzersiz tanımlayıcısı.

api_version dize  (isteğe bağlı)

API'nin hangi sürümünün kullanılacağı.

Yanıt

Başarılı olursa yanıt boş olur.

Etkileşimi Silme

Etkileşimi iptal etme

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

Kimliğe göre bir etkileşimi iptal eder. Bu yalnızca hâlâ yayınlanmakta olan arka plan etkileşimleri için geçerlidir.

Yol / Sorgu Parametreleri

id dize  (zorunlu)

Alınacak etkileşimin benzersiz tanımlayıcısı.

api_version dize  (isteğe bağlı)

API'nin hangi sürümünün kullanılacağı.

Yanıt

Interaction kaynağını döndürür.

Etkileşimi İptal Etme

Örnek Yanıt

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

Kaynaklar

Etkileşim

Etkileşim kaynağı.

Alanlar

model ModelOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Model"in adı.

Olası değerler:

  • gemini-2.5-pro

    Kodlama ve karmaşık akıl yürütme görevlerinde üstün performans gösteren, en yeni çok amaçlı modelimiz.

  • gemini-2.5-flash

    1 milyon parçalık bağlam penceresini destekleyen ve düşünme bütçelerine sahip ilk karma akıl yürütme modelimiz.

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

    2.5 Flash modeline dayalı en yeni model. 2.5 Flash Preview, büyük ölçekli işleme, düşük gecikme süresi, düşünme gerektiren yüksek hacimli görevler ve temsilci kullanım alanları için en iyisidir.

  • gemini-2.5-flash-lite

    Büyük ölçekli kullanım için tasarlanan en küçük ve en uygun maliyetli modelimiz.

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

    Maliyet verimliliği, yüksek işleme hızı ve yüksek kalite için optimize edilmiş Gemini 2.5 Flash Lite'a dayalı en yeni model.

  • gemini-2.5-flash-preview-native-audio-dialog

    Daha iyi hız, ses doğallığı, ayrıntı ve ruh haliyle daha yüksek kaliteli ses çıkışları için optimize edilmiş yerel ses modellerimiz.

  • gemini-2.5-flash-image-preview

    Hız, esneklik ve bağlamsal anlayış için optimize edilmiş yerel görüntü üretme modelimiz. Metin girişi ve çıkışı, 2,5 Flash ile aynı şekilde fiyatlandırılır.

  • gemini-2.5-pro-preview-tts

    2.5 Pro metin okuma ses modelimiz, daha doğal çıkışlar ve daha kolay yönlendirilen istemler için güçlü ve düşük gecikmeli konuşma üretimi amacıyla optimize edilmiştir.

  • gemini-3-pro-preview

    En akıllı modelimiz; en gelişmiş akıl yürütme, çok formatlı anlama, güçlü aracı ve vibe kodlama özelliklerine sahiptir.

İsteminizi tamamlayacak model.\n\nEk ayrıntılar için [modeller](https://ai.google.dev/gemini-api/docs/models) bölümüne bakın.

agent AgentOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Agent"ın adı.

Olası değerler:

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

    Gemini Deep Research Temsilcisi

Etkileşim kurulacak temsilci.

id dize  (isteğe bağlı)

Yalnızca çıkış. Etkileşim tamamlama için benzersiz tanımlayıcı.

status enum (string)  (isteğe bağlı)

Yalnızca çıkış. Etkileşimin durumu.

Olası değerler:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
created string  (isteğe bağlı)

Yalnızca çıkış. Yanıtın oluşturulduğu saat, ISO 8601 biçiminde (YYYY-AA-GGTsa:dk:snZ).

updated dize  (isteğe bağlı)

Yalnızca çıkış. Yanıtın en son güncellendiği ISO 8601 biçimindeki saat (YYYY-AA-GGTsa:dk:snZ).

role string  (isteğe bağlı)

Yalnızca çıkış. Etkileşimin rolü.

outputs array (Content)  (isteğe bağlı)

Yalnızca çıkış. Modelin yanıtları.

object string  (isteğe bağlı)

Yalnızca çıkış. Etkileşimin nesne türü. Her zaman "interaction" olarak ayarlanır.

Her zaman "interaction" olarak ayarlanır.

usage Kullanım  (isteğe bağlı)

Yalnızca çıkış. Etkileşim isteğinin jeton kullanımıyla ilgili istatistikler.

Etkileşim isteğinin jeton kullanımıyla ilgili istatistikler.

Alanlar

total_input_tokens integer  (isteğe bağlı)

İstemdeki (bağlam) jeton sayısı.

input_tokens_by_modality ModalityTokens  (isteğe bağlı)

Giriş jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_cached_tokens integer  (isteğe bağlı)

İstemdeki önbelleğe alınmış bölümdeki (önbelleğe alınmış içerik) jeton sayısı.

cached_tokens_by_modality ModalityTokens  (isteğe bağlı)

Önbelleğe alınmış jeton kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_output_tokens integer  (isteğe bağlı)

Oluşturulan tüm yanıtlardaki toplam jeton sayısı.

output_tokens_by_modality ModalityTokens  (isteğe bağlı)

Çıkış jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_tool_use_tokens integer  (isteğe bağlı)

Araç kullanma istemlerinde bulunan jeton sayısı.

tool_use_tokens_by_modality ModalityTokens  (isteğe bağlı)

Aracı kullanma jetonlarının kullanımının, modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_reasoning_tokens integer  (isteğe bağlı)

Düşünme modelleri için düşünce jetonlarının sayısı.

total_tokens integer  (isteğe bağlı)

Etkileşim isteği için toplam jeton sayısı (istem + yanıtlar + diğer dahili jetonlar).

previous_interaction_id string  (isteğe bağlı)

Önceki etkileşimin kimliği (varsa).

Örnekler

Örnek

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

Veri Modelleri

İçerik

Yanıtın içeriği.

Olası Türler

Polimorfik ayrıştırıcı: type

TextContent

Metin içeriği bloğu.

text string  (isteğe bağlı)

Metin içeriği.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "text" olarak ayarlanır.

notlar Not  (isteğe bağlı)

Model tarafından üretilen içeriklerin alıntı bilgileri.

Model tarafından üretilen içeriklerin alıntı bilgileri.

Alanlar

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

source dize  (isteğe bağlı)

Metnin bir bölümü için atfedilen kaynak. URL, başlık veya başka bir tanımlayıcı olabilir.

ImageContent

Resim içerik bloğu.

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type ImageMimeTypeOption  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

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

Resmin MIME türü.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "image" olarak ayarlanır.

resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high

AudioContent

Sesli içerik bloğu

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type AudioMimeTypeOption  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

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

Sesin MIME türü.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "audio" olarak ayarlanır.

DocumentContent

Doküman içerik bloğu.

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "document" olarak ayarlanır.

VideoContent

Video içerik bloğu

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type VideoMimeTypeOption  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

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

Videonun MIME türü.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "video" olarak ayarlanır.

resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high

ThoughtContent

Düşünce içerik bloğu.

signature string  (isteğe bağlı)

Oluşturma işlemine dahil edilecek arka uç kaynağıyla eşleşen imza.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "thought" olarak ayarlanır.

özet ThoughtSummary  (isteğe bağlı)

Düşüncenin özeti.

Düşüncenin özeti.

FunctionCallContent

İşlev aracı çağrısı içerik bloğu.

name string  (zorunlu)

Çağrılacak aracın adı.

arguments object  (zorunlu)

İşleve geçirilecek bağımsız değişkenler.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "function_call" olarak ayarlanır.

id dize  (zorunlu)

Bu belirli araç çağrısının benzersiz kimliği.

FunctionResultContent

Bir işlev aracı sonuç içerik bloğu.

name string  (isteğe bağlı)

Çağrılan aracın adı.

is_error boolean  (isteğe bağlı)

Araç çağrısının hatayla sonuçlanıp sonuçlanmadığı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "function_result" olarak ayarlanır.

result object veya string  (zorunlu)

Araç çağrısının sonucu.

call_id dize  (zorunlu)

İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

CodeExecutionCallContent

Kod yürütme içeriği.

arguments CodeExecutionCallArguments  (isteğe bağlı)

Kod yürütmeye aktarılacak bağımsız değişkenler.

Kod yürütmeye aktarılacak bağımsız değişkenler.

Alanlar

language enum (string)  (isteğe bağlı)

"code"un programlama dili.

Olası değerler:

  • python
code string  (isteğe bağlı)

Yürütülecek kod.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "code_execution_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

CodeExecutionResultContent

Kod yürütme sonucu içeriği.

result string  (isteğe bağlı)

Kod yürütmenin çıkışı.

is_error boolean  (isteğe bağlı)

Kod yürütme işleminin hatayla sonuçlanıp sonuçlanmadığı.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "code_execution_result" olarak ayarlanır.

call_id dize  (isteğe bağlı)

Kod yürütme çağrısı bloğundaki kimlikle eşleşecek kimlik.

UrlContextCallContent

URL bağlam içeriği.

arguments UrlContextCallArguments  (isteğe bağlı)

URL bağlamına aktarılacak bağımsız değişkenler.

URL bağlamına aktarılacak bağımsız değişkenler.

Alanlar

urls array (string)  (isteğe bağlı)

Getirilecek URL'ler.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "url_context_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

UrlContextResultContent

URL bağlamı sonuç içeriği.

signature string  (isteğe bağlı)

URL bağlamı sonucunun imzası.

result UrlContextResult  (isteğe bağlı)

URL bağlamının sonuçları.

URL bağlamının sonucu.

Alanlar

url dize  (isteğe bağlı)

Getirilen URL.

status enum (string)  (isteğe bağlı)

URL alma işleminin durumu.

Olası değerler:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (isteğe bağlı)

URL bağlamının hataya neden olup olmadığı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "url_context_result" olarak ayarlanır.

call_id dize  (isteğe bağlı)

URL bağlamı çağrı bloğundaki kimlikle eşleşecek kimlik.

GoogleSearchCallContent

Google Arama içeriği.

arguments GoogleSearchCallArguments  (isteğe bağlı)

Google Arama'ya iletilecek bağımsız değişkenler.

Google Arama'ya iletilecek bağımsız değişkenler.

Alanlar

queries array (string)  (isteğe bağlı)

Takip eden web araması için web arama sorguları.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "google_search_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

GoogleSearchResultContent

Google arama sonucu içeriği.

signature string  (isteğe bağlı)

Google arama sonucunun imzası.

result GoogleSearchResult  (isteğe bağlı)

Google Arama'nın sonuçları.

Google Arama'nın sonucu.

Alanlar

url dize  (isteğe bağlı)

Arama sonucunun URI referansı.

title string  (isteğe bağlı)

Arama sonucunun başlığı.

rendered_content string  (isteğe bağlı)

Bir web sayfasına veya uygulama web görünümüne yerleştirilebilen web içeriği snippet'i.

is_error boolean  (isteğe bağlı)

Google Arama'nın hatayla sonuçlanıp sonuçlanmadığı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "google_search_result" olarak ayarlanır.

call_id dize  (isteğe bağlı)

Google arama çağrısı bloğundaki kimlikle eşleşecek kimlik.

McpServerToolCallContent

MCPServer aracı çağrısı içeriği.

name string  (zorunlu)

Çağrılan aracın adı.

server_name string  (zorunlu)

Kullanılan MCP sunucusunun adı.

arguments object  (zorunlu)

İşlevin bağımsız değişkenlerinin JSON nesnesi.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "mcp_server_tool_call" olarak ayarlanır.

id dize  (zorunlu)

Bu belirli araç çağrısının benzersiz kimliği.

McpServerToolResultContent

MCPServer aracı sonuç içeriği.

name string  (isteğe bağlı)

Bu belirli araç çağrısı için çağrılan aracın adı.

server_name string  (isteğe bağlı)

Kullanılan MCP sunucusunun adı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "mcp_server_tool_result" olarak ayarlanır.

result object veya string  (zorunlu)

Araç çağrısının sonucu.

call_id dize  (zorunlu)

MCP sunucusu araç çağrısı blokundaki kimlikle eşleşecek kimlik.

FileSearchResultContent

Dosya arama sonucu içeriği.

result FileSearchResult  (isteğe bağlı)

Dosya Arama'nın sonuçları.

Dosya Arama'nın sonucu.

Alanlar

title string  (isteğe bağlı)

Arama sonucunun başlığı.

text string  (isteğe bağlı)

Arama sonucunun metni.

file_search_store dize  (isteğe bağlı)

Dosya arama mağazasının adı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "file_search_result" olarak ayarlanır.

Örnekler

Metin

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

Resim

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

Ses

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

Belge

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

Video

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

Düşünüldü

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

İşlev Çağrısı

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

İşlev Sonucu

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": {
    "weather": "sunny"
  }
}

Kod Yürütme Çağrısı

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

Kod Yürütme Sonucu

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

URL Bağlamı Çağrısı

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

URL Bağlamı Sonucu

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

Google Arama Araması

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

Google Arama Sonucu

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

Mcp Server Tool Call

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

Mcp Server Tool Result

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

Dosya arama sonucu

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

Araç

Olası Türler

Polimorfik ayrıştırıcı: type

İşlev

Model tarafından kullanılabilen bir araç.

name string  (isteğe bağlı)

İşlevin adı.

description string  (isteğe bağlı)

İşlevin açıklaması.

parameters object  (isteğe bağlı)

İşlevin parametreleri için JSON şeması.

type string  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "function" olarak ayarlanır.

GoogleSearch

Modelin Google'da arama yapmak için kullanabileceği bir araç.

type string  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_search" olarak ayarlanır.

CodeExecution

Modelin kodu yürütmek için kullanabileceği bir araç.

type string  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "code_execution" olarak ayarlanır.

UrlContext

Modelin URL bağlamını getirmek için kullanabileceği bir araç.

type string  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_context" olarak ayarlanır.

ComputerUse

Modelin bilgisayarla etkileşim kurmak için kullanabileceği bir araç.

type string  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "computer_use" olarak ayarlanır.

environment enum (string)  (isteğe bağlı)

Çalıştırılan ortam.

Olası değerler:

  • browser
excludedPredefinedFunctions array (string)  (isteğe bağlı)

Model çağrısından hariç tutulan önceden tanımlanmış işlevlerin listesi.

McpServer

MCPServer, işlemleri gerçekleştirmek için model tarafından çağrılabilen bir sunucudur.

type string  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "mcp_server" olarak ayarlanır.

name string  (isteğe bağlı)

MCPServer'ın adı.

url dize  (isteğe bağlı)

MCPServer uç noktasının tam URL'si. Örnek: "https://api.example.com/mcp"

headers object  (isteğe bağlı)

İsteğe bağlı: Gerekirse kimlik doğrulama başlıkları, zaman aşımları vb. için alanlar.

allowed_tools AllowedTools  (isteğe bağlı)

İzin verilen araçlar

İzin verilen araçların yapılandırması.

Alanlar

mode ToolChoiceType  (isteğe bağlı)

Araç seçiminin modu.

Olası değerler:

  • auto
  • any
  • none
  • validated

tools array (string)  (isteğe bağlı)

İzin verilen araçların adları.

FileSearch

Modelin dosyaları aramak için kullanabileceği bir araç.

file_search_store_names array (string)  (isteğe bağlı)

Dosya, aranacak mağaza adlarını içerir.

top_k integer  (isteğe bağlı)

Alınacak semantik alma parçalarının sayısı.

metadata_filter dize  (isteğe bağlı)

Anlamsal alma belgelerine ve parçalarına uygulanacak meta veri filtresi.

type string  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_search" olarak ayarlanır.

Örnekler

İşlev

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

CANNOT TRANSLATE

Alanlar

role string  (isteğe bağlı)

Bu dönüşün başlatıcısı. Giriş için kullanıcı, model çıkışı için model olmalıdır.

content array (Content) or string  (isteğe bağlı)

Dönüşün içeriği.

Örnekler

Kullanıcı Sırası

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

Model Turn

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

InteractionSseEvent

Olası Türler

Polimorfik ayrıştırıcı: event_type

InteractionEvent

event_type enum (string)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • interaction.start
  • interaction.complete
interaction Interaction  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

InteractionStatusUpdate

interaction_id dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

status enum (string)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
event_type dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Her zaman "interaction.status_update" olarak ayarlanır.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

ContentStart

index integer  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

content İçerik  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

event_type dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Her zaman "content.start" olarak ayarlanır.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

ContentDelta

index integer  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

event_type dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Her zaman "content.delta" olarak ayarlanır.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

delta object  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası Türler

Polimorfik ayrıştırıcı: type

TextDelta

text string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "text" olarak ayarlanır.

notlar Not  (isteğe bağlı)

Model tarafından üretilen içeriklerin alıntı bilgileri.

Model tarafından üretilen içeriklerin alıntı bilgileri.

Alanlar

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

source dize  (isteğe bağlı)

Metnin bir bölümü için atfedilen kaynak. URL, başlık veya başka bir tanımlayıcı olabilir.

ImageDelta

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type ImageMimeTypeOption  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

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

Resmin MIME türü.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "image" olarak ayarlanır.

resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high

AudioDelta

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type AudioMimeTypeOption  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

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

Sesin MIME türü.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "audio" olarak ayarlanır.

DocumentDelta

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "document" olarak ayarlanır.

VideoDelta

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type VideoMimeTypeOption  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

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

Videonun MIME türü.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "video" olarak ayarlanır.

resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high

ThoughtSummaryDelta

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "thought_summary" olarak ayarlanır.

content ImageContent veya TextContent  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

ThoughtSignatureDelta

signature string  (isteğe bağlı)

Oluşturma işlemine dahil edilecek arka uç kaynağıyla eşleşen imza.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "thought_signature" olarak ayarlanır.

FunctionCallDelta

name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

arguments object  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "function_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

FunctionResultDelta

name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "function_result" olarak ayarlanır.

result object veya string  (isteğe bağlı)

Araç çağrısı sonucu deltası.

call_id dize  (isteğe bağlı)

İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Kod yürütmeye aktarılacak bağımsız değişkenler.

Alanlar

language enum (string)  (isteğe bağlı)

"code"un programlama dili.

Olası değerler:

  • python
code string  (isteğe bağlı)

Yürütülecek kod.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "code_execution_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

CodeExecutionResultDelta

result string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

signature string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "code_execution_result" olarak ayarlanır.

call_id dize  (isteğe bağlı)

İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

UrlContextCallDelta

arguments UrlContextCallArguments  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

URL bağlamına aktarılacak bağımsız değişkenler.

Alanlar

urls array (string)  (isteğe bağlı)

Getirilecek URL'ler.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "url_context_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

UrlContextResultDelta

signature string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

result UrlContextResult  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

URL bağlamının sonucu.

Alanlar

url dize  (isteğe bağlı)

Getirilen URL.

status enum (string)  (isteğe bağlı)

URL alma işleminin durumu.

Olası değerler:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "url_context_result" olarak ayarlanır.

call_id dize  (isteğe bağlı)

İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Google Arama'ya iletilecek bağımsız değişkenler.

Alanlar

queries array (string)  (isteğe bağlı)

Takip eden web araması için web arama sorguları.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "google_search_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

GoogleSearchResultDelta

signature string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

result GoogleSearchResult  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Google Arama'nın sonucu.

Alanlar

url dize  (isteğe bağlı)

Arama sonucunun URI referansı.

title string  (isteğe bağlı)

Arama sonucunun başlığı.

rendered_content string  (isteğe bağlı)

Bir web sayfasına veya uygulama web görünümüne yerleştirilebilen web içeriği snippet'i.

is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "google_search_result" olarak ayarlanır.

call_id dize  (isteğe bağlı)

İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

McpServerToolCallDelta

name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

server_name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

arguments object  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "mcp_server_tool_call" olarak ayarlanır.

id dize  (isteğe bağlı)

Bu belirli araç çağrısının benzersiz kimliği.

McpServerToolResultDelta

name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

server_name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "mcp_server_tool_result" olarak ayarlanır.

result object veya string  (isteğe bağlı)

Araç çağrısı sonucu deltası.

call_id dize  (isteğe bağlı)

İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

FileSearchResultDelta

result FileSearchResult  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Dosya Arama'nın sonucu.

Alanlar

title string  (isteğe bağlı)

Arama sonucunun başlığı.

text string  (isteğe bağlı)

Arama sonucunun metni.

file_search_store dize  (isteğe bağlı)

Dosya arama mağazasının adı.

type string  (zorunlu)

İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.

Her zaman "file_search_result" olarak ayarlanır.

ContentStop

index integer  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

event_type dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Her zaman "content.stop" olarak ayarlanır.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

ErrorEvent

event_type dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Her zaman "error" olarak ayarlanır.

error Error  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Bir etkileşimden gelen hata mesajı.

Alanlar

code string  (isteğe bağlı)

Hata türünü tanımlayan bir URI.

message string  (isteğe bağlı)

Kullanıcıların okuyabileceği bir hata mesajı.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

Örnekler

Etkileşimin Başlangıcı

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

Etkileşim Tamamlandı

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

Etkileşim Durumu Güncellemesi

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

İçeriğin Başlangıcı

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

İçerik Deltası

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

İçeriği Durdurma

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

Hata Etkinliği

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