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, çok formatlı olacak şekilde sıfırdan geliştirilen en yetenekli modelimizdir. Dil, resim, ses, video ve kod gibi farklı bilgi türlerini genelleyip akıcı bir şekilde anlayabilir, birbiriyle harmanlayabilir ve tüm bu formatlar arasında işlem yapabilir. Gemini API'yi metin ve resimlerde 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.

Markdown olarak görüntüle OpenAPI Spesifikasyonu'nu görüntüleme

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-computer-use-preview-10-2025

    Doğrudan arayüz etkileşimi için tasarlanmış, Gemini'ın dijital ortamlarda algılama ve gezinme olanağı sağlayan bir ajan tabanlı yetenek modeli.

  • gemini-2.5-flash

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

  • gemini-2.5-flash-image

    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-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 gönderim hacmi ve yüksek kalite için optimize edilmiş Gemini 2.5 Flash lite'a dayalı en yeni model.

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

    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-preview-09-2025

    2.5 Flash modeline dayalı en yeni model. 2.5 Flash Önizlemesi; 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 uygun seçenektir.

  • gemini-2.5-flash-preview-tts

    Güçlü ve düşük gecikmeli, kontrol edilebilir konuşma üretimi için optimize edilmiş 2.5 Flash metin okuma modelimiz.

  • gemini-2.5-pro

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

  • 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-flash-preview

    Hız için tasarlanmış en akıllı modelimiz. Yeni nesil zekayı üstün arama ve temellendirme özellikleriyle birleştirir.

  • gemini-3-pro-image-preview

    Son teknoloji ürünü görüntü üretme ve düzenleme modeli.

  • gemini-3-pro-preview

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

  • gemini-3.1-pro-preview

    Eşi benzeri görülmemiş derinlik ve ayrıntıya sahip, güçlü çok formatlı anlama ve kodlama özellikleriyle en yeni SOTA akıl yürütme modelimiz.

  • gemini-3.1-flash-image-preview

    Flash hızında verimlilik ve gerçekliğe dayalı üretim özellikleriyle profesyonel düzeyde görsel zeka.

  • gemini-3.1-flash-lite-preview

    Yüksek hacimli ajan tabanlı görevler, çeviri ve basit veri işleme için optimize edilmiş, en uygun maliyetli modelimiz.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Güçlü ve düşük gecikmeli konuşma üretimi. Doğal çıkışlar, yönlendirilebilir istemler ve hassas anlatım kontrolü için yeni etkileyici ses etiketlerinden yararlanın.

  • lyria-3-clip-preview

    Yüksek kaliteli ses klipleri ve hassas ritmik kontrol için optimize edilmiş, düşük gecikmeli müzik üretme modelimiz.

  • lyria-3-pro-preview

    Gelişmiş, tam şarkı üretken modelimiz; kompozisyonu derinlemesine anlar, farklı müzik stillerinde hassas yapısal kontrol ve karmaşık geçişler için optimize edilmiştir.

İ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 Ajanı

  • deep-research-preview-04-2026

    Gemini Deep Research Ajanı

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

    Gemini Deep Research Max Agent

Etkileşime geçilecek temsilci.

input İçerik veya dizi (İçerik) ya da dizi (Adım) 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 ResponseFormat veya ResponseFormatList  (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 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ı)

Yalnızca giriş. 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.

thinking_level ThinkingLevel  (isteğe bağlı)

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

Olası değerler:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (isteğe bağlı)

Yanıta düşünce özetlerinin dahil edilip edilmeyeceğ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.

image_config ImageConfig  (isteğe bağlı)

Resim etkileşimi için yapılandırma.

Resim etkileşimi yapılandırması.

Alanlar

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

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

Olası değerler:

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (isteğe bağlı)

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

Olası değerler:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig veya ToolChoiceType  (isteğe bağlı)

Araç seçimi yapılandırması.

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 ayırıcı: type

DynamicAgentConfig

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

type object  (zorunlu)

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

Her zaman "dynamic" olarak ayarlanır.

DeepResearchAgentConfig

Deep Research temsilcisinin yapılandırması.

type object  (zorunlu)

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

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

thinking_summaries ThinkingSummaries  (isteğe bağlı)

Yanıta düşünce özetlerinin dahil edilip edilmeyeceği.

Olası değerler: