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
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-proKodlama ve karmaşık akıl yürütme görevlerinde üstün performans gösteren, en yeni çok amaçlı modelimiz.
-
gemini-2.5-flash1 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-20252.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-liteBüyük ölçekli kullanım için tasarlanan en küçük ve en uygun maliyetli modelimiz.
-
gemini-2.5-flash-lite-preview-09-2025Maliyet 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-dialogDaha 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-previewHı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-tts2.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-previewEn akıllı modelimiz; en gelişmiş akıl yürütme, çok formatlı anlama, güçlü aracı ve vibe kodlama özelliklerine sahiptir.
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-2025Gemini Deep Research Temsilcisi
Etkileşim için girişler (hem Model hem de Temsilci için ortaktır).
Etkileşim için sistem talimatı.
Modelin etkileşim sırasında çağırabileceği araç bildirimlerinin listesi.
Oluşturulan yanıtın, bu alanda belirtilen JSON şemasına uygun bir JSON nesnesi olmasını zorunlu kılar.
Yanıtın MIME türü. response_format ayarlanmışsa bu parametre gereklidir.
Yalnızca giriş. Etkileşimin yayınlanıp yayınlanmayacağı.
Yalnızca giriş. Yanıtın ve isteğin daha sonra alınmak üzere saklanıp saklanmayacağı.
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.
Alanlar
Çıkışın rastgeleliğini kontrol eder.
Örnekleme sırasında dikkate alınacak jetonların maksimum kümülatif olasılığı.
Yeniden üretilebilirlik için kod çözme işleminde kullanılan başlangıç değeri.
Çıkış etkileşimini durduracak karakter dizilerinin listesi.
tool_choice ToolChoice (isteğe bağlı)
Etkileşim için kullanılan araç.
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ı.
Alanlar
mode ToolChoiceType (isteğe bağlı)
Araç seçiminin modu.
Olası değerler:
-
auto -
any -
none -
validated
İ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
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.
Alanlar
Konuşmacının sesi.
Konuşmanın dili.
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.
İç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ı.
İç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
Ö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
Tek bir etkileşimin tüm ayrıntılarını `Interaction.id` değerine göre alır.
Yol / Sorgu Parametreleri
Alınacak etkileşimin benzersiz tanımlayıcısı.
Doğru değerine ayarlanırsa oluşturulan içerik artımlı olarak yayınlanır.
Varsayılan değer: False
İ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'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
Etkileşimi kimliğe göre siler.
Yol / Sorgu Parametreleri
Silinecek etkileşimin benzersiz tanımlayıcısı.
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
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
Alınacak etkileşimin benzersiz tanımlayıcısı.
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-proKodlama ve karmaşık akıl yürütme görevlerinde üstün performans gösteren, en yeni çok amaçlı modelimiz.
-
gemini-2.5-flash1 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-20252.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-liteBüyük ölçekli kullanım için tasarlanan en küçük ve en uygun maliyetli modelimiz.
-
gemini-2.5-flash-lite-preview-09-2025Maliyet 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-dialogDaha 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-previewHı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-tts2.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-previewEn akıllı modelimiz; en gelişmiş akıl yürütme, çok formatlı anlama, güçlü aracı ve vibe kodlama özelliklerine sahiptir.
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-2025Gemini Deep Research Temsilcisi
Yalnızca çıkış. Etkileşim tamamlama için benzersiz tanımlayıcı.
Yalnızca çıkış. Etkileşimin durumu.
Olası değerler:
-
in_progress -
requires_action -
completed -
failed -
cancelled
Yalnızca çıkış. Yanıtın oluşturulduğu saat, ISO 8601 biçiminde (YYYY-AA-GGTsa:dk:snZ).
Yalnızca çıkış. Yanıtın en son güncellendiği ISO 8601 biçimindeki saat (YYYY-AA-GGTsa:dk:snZ).
Yalnızca çıkış. Etkileşimin rolü.
Yalnızca çıkış. Modelin yanıtları.
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.
Alanlar
İ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ü.
Alanlar
modality ResponseModality (isteğe bağlı)
Jeton sayısıyla ilişkili yöntem.
Olası değerler:
-
text -
image -
audio
Modalite için jeton sayısı.
İ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ü.
Alanlar
modality ResponseModality (isteğe bağlı)
Jeton sayısıyla ilişkili yöntem.
Olası değerler:
-
text -
image -
audio
Modalite için jeton sayısı.
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ü.
Alanlar
modality ResponseModality (isteğe bağlı)
Jeton sayısıyla ilişkili yöntem.
Olası değerler:
-
text -
image -
audio
Modalite için jeton sayısı.
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ü.
Alanlar
modality ResponseModality (isteğe bağlı)
Jeton sayısıyla ilişkili yöntem.
Olası değerler:
-
text -
image -
audio
Modalite için jeton sayısı.
Düşünme modelleri için düşünce jetonlarının sayısı.
Etkileşim isteği için toplam jeton sayısı (istem + yanıtlar + diğer dahili jetonlar).
Ö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.
Metin içeriği.
İç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.
Alanlar
Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.
Atfedilen segmentin bitişi (hariç).
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.
Hiçbir açıklama sağlanmadı.
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
İç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
Hiçbir açıklama sağlanmadı.
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
İç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.
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
İç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
Hiçbir açıklama sağlanmadı.
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
İç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.
Oluşturma işlemine dahil edilecek arka uç kaynağıyla eşleşen imza.
İç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.
FunctionCallContent
İşlev aracı çağrısı içerik bloğu.
Çağrılacak aracın adı.
İşleve geçirilecek bağımsız değişkenler.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "function_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
FunctionResultContent
Bir işlev aracı sonuç içerik bloğu.
Çağrılan aracın adı.
Araç çağrısının hatayla sonuçlanıp sonuçlanmadığı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "function_result" olarak ayarlanır.
Araç çağrısının sonucu.
İş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.
Alanlar
"code"un programlama dili.
Olası değerler:
-
python
Yürütülecek kod.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "code_execution_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
CodeExecutionResultContent
Kod yürütme sonucu içeriği.
Kod yürütmenin çıkışı.
Kod yürütme işleminin hatayla sonuçlanıp sonuçlanmadığı.
Arka uç doğrulaması için imza karması.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "code_execution_result" olarak ayarlanır.
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.
Alanlar
Getirilecek URL'ler.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "url_context_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
UrlContextResultContent
URL bağlamı sonuç içeriği.
URL bağlamı sonucunun imzası.
result UrlContextResult (isteğe bağlı)
URL bağlamının sonuçları.
Alanlar
Getirilen URL.
URL alma işleminin durumu.
Olası değerler:
-
success -
error -
paywall -
unsafe
URL bağlamının hataya neden olup olmadığı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "url_context_result" olarak ayarlanır.
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.
Alanlar
Takip eden web araması için web arama sorguları.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "google_search_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
GoogleSearchResultContent
Google arama sonucu içeriği.
Google arama sonucunun imzası.
result GoogleSearchResult (isteğe bağlı)
Google Arama'nın sonuçları.
Alanlar
Arama sonucunun URI referansı.
Arama sonucunun başlığı.
Bir web sayfasına veya uygulama web görünümüne yerleştirilebilen web içeriği snippet'i.
Google Arama'nın hatayla sonuçlanıp sonuçlanmadığı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "google_search_result" olarak ayarlanır.
Google arama çağrısı bloğundaki kimlikle eşleşecek kimlik.
McpServerToolCallContent
MCPServer aracı çağrısı içeriği.
Çağrılan aracın adı.
Kullanılan MCP sunucusunun adı.
İşlevin bağımsız değişkenlerinin JSON nesnesi.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "mcp_server_tool_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
McpServerToolResultContent
MCPServer aracı sonuç içeriği.
Bu belirli araç çağrısı için çağrılan aracın adı.
Kullanılan MCP sunucusunun adı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "mcp_server_tool_result" olarak ayarlanır.
Araç çağrısının sonucu.
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ı.
Alanlar
Arama sonucunun başlığı.
Arama sonucunun metni.
Dosya arama mağazasının adı.
İç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ç.
İşlevin adı.
İşlevin açıklaması.
İşlevin parametreleri için JSON şeması.
Hiçbir açıklama sağlanmadı.
Her zaman "function" olarak ayarlanır.
GoogleSearch
Modelin Google'da arama yapmak için kullanabileceği bir araç.
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ç.
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ç.
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ç.
Hiçbir açıklama sağlanmadı.
Her zaman "computer_use" olarak ayarlanır.
Çalıştırılan ortam.
Olası değerler:
-
browser
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.
Hiçbir açıklama sağlanmadı.
Her zaman "mcp_server" olarak ayarlanır.
MCPServer'ın adı.
MCPServer uç noktasının tam URL'si. Örnek: "https://api.example.com/mcp"
İ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
Alanlar
mode ToolChoiceType (isteğe bağlı)
Araç seçiminin modu.
Olası değerler:
-
auto -
any -
none -
validated
İzin verilen araçların adları.
FileSearch
Modelin dosyaları aramak için kullanabileceği bir araç.
Dosya, aranacak mağaza adlarını içerir.
Alınacak semantik alma parçalarının sayısı.
Anlamsal alma belgelerine ve parçalarına uygulanacak meta veri filtresi.
Hiçbir açıklama sağlanmadı.
Her zaman "file_search" olarak ayarlanır.
Örnekler
İşlev
GoogleSearch
CodeExecution
UrlContext
ComputerUse
McpServer
FileSearch
CANNOT TRANSLATE
Alanlar
Bu dönüşün başlatıcısı. Giriş için kullanıcı, model çıkışı için model olmalıdır.
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
Hiçbir açıklama sağlanmadı.
Olası değerler:
-
interaction.start -
interaction.complete
Hiçbir açıklama sağlanmadı.
Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.
InteractionStatusUpdate
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Olası değerler:
-
in_progress -
requires_action -
completed -
failed -
cancelled
Hiçbir açıklama sağlanmadı.
Her zaman "interaction.status_update" olarak ayarlanır.
Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.
ContentStart
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Her zaman "content.start" olarak ayarlanır.
Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.
ContentDelta
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Her zaman "content.delta" olarak ayarlanır.
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
Hiçbir açıklama sağlanmadı.
İç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.
Alanlar
Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.
Atfedilen segmentin bitişi (hariç).
Metnin bir bölümü için atfedilen kaynak. URL, başlık veya başka bir tanımlayıcı olabilir.
ImageDelta
Hiçbir açıklama sağlanmadı.
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
İç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
Hiçbir açıklama sağlanmadı.
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
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "audio" olarak ayarlanır.
DocumentDelta
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "document" olarak ayarlanır.
VideoDelta
Hiçbir açıklama sağlanmadı.
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
İç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
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "thought_summary" olarak ayarlanır.
Hiçbir açıklama sağlanmadı.
ThoughtSignatureDelta
Oluşturma işlemine dahil edilecek arka uç kaynağıyla eşleşen imza.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "thought_signature" olarak ayarlanır.
FunctionCallDelta
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "function_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
FunctionResultDelta
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "function_result" olarak ayarlanır.
Araç çağrısı sonucu deltası.
İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.
CodeExecutionCallDelta
arguments CodeExecutionCallArguments (isteğe bağlı)
Hiçbir açıklama sağlanmadı.
Alanlar
"code"un programlama dili.
Olası değerler:
-
python
Yürütülecek kod.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "code_execution_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
CodeExecutionResultDelta
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "code_execution_result" olarak ayarlanır.
İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.
UrlContextCallDelta
arguments UrlContextCallArguments (isteğe bağlı)
Hiçbir açıklama sağlanmadı.
Alanlar
Getirilecek URL'ler.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "url_context_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
UrlContextResultDelta
Hiçbir açıklama sağlanmadı.
result UrlContextResult (isteğe bağlı)
Hiçbir açıklama sağlanmadı.
Alanlar
Getirilen URL.
URL alma işleminin durumu.
Olası değerler:
-
success -
error -
paywall -
unsafe
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "url_context_result" olarak ayarlanır.
İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.
GoogleSearchCallDelta
arguments GoogleSearchCallArguments (isteğe bağlı)
Hiçbir açıklama sağlanmadı.
Alanlar
Takip eden web araması için web arama sorguları.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "google_search_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
GoogleSearchResultDelta
Hiçbir açıklama sağlanmadı.
result GoogleSearchResult (isteğe bağlı)
Hiçbir açıklama sağlanmadı.
Alanlar
Arama sonucunun URI referansı.
Arama sonucunun başlığı.
Bir web sayfasına veya uygulama web görünümüne yerleştirilebilen web içeriği snippet'i.
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "google_search_result" olarak ayarlanır.
İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.
McpServerToolCallDelta
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "mcp_server_tool_call" olarak ayarlanır.
Bu belirli araç çağrısının benzersiz kimliği.
McpServerToolResultDelta
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "mcp_server_tool_result" olarak ayarlanır.
Araç çağrısı sonucu deltası.
İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.
FileSearchResultDelta
result FileSearchResult (isteğe bağlı)
Hiçbir açıklama sağlanmadı.
Alanlar
Arama sonucunun başlığı.
Arama sonucunun metni.
Dosya arama mağazasının adı.
İçerik oneof'u için OpenAPI türü ayırıcı olarak kullanılır.
Her zaman "file_search_result" olarak ayarlanır.
ContentStop
Hiçbir açıklama sağlanmadı.
Hiçbir açıklama sağlanmadı.
Her zaman "content.stop" olarak ayarlanır.
Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.
ErrorEvent
Hiçbir açıklama sağlanmadı.
Her zaman "error" olarak ayarlanır.
error Error (isteğe bağlı)
Hiçbir açıklama sağlanmadı.
Alanlar
Hata türünü tanımlayan bir URI.
Kullanıcıların okuyabileceği bir hata mesajı.
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" } }