Interactions API: Gemini modelleri ve temsilcileri için birincil arayüzümüz

Bugün, Interactions API'nin genel kullanıma sunulduğunu ve artık Gemini modelleri ve ajanlarıyla etkileşim için birincil API'miz olduğunu duyuruyoruz. Genel betasını Aralık 2025'te başlatmıştık ve kısa sürede geliştiricilerin Gemini ile uygulama oluşturmak için en sevdiği yöntem haline geldi.

Bu GA sürümüyle birlikte API artık kararlı bir şemaya sahip ve geliştiricilerin talep ettiği Managed Agents, arka plan yürütme, Gemini Omni (yakında) ve daha fazlası gibi önemli yeni yetenekler ekledik. Tüm dokümantasyonumuz artık varsayılan olarak Interactions API'yi kullanıyor ve ekosistem ortaklarımızla birlikte bunu 3P SDK'lar ve Kütüphaneler genelinde varsayılan arayüz haline getirmek için çalışıyoruz.

Gemini ile oluşturmanın en basit yolu

İster bir modeli çağırıyor ister bir ajanı çalıştırıyor olun, Interactions API sizi birkaç satır kodla hedefe ulaştırır. Çıkarım için bir model kimliği veya otonom görevler için bir ajan kimliği iletin ve uzun süren işlemler için background=True olarak ayarlayın.

1from google import genai
2
3client = genai.Client()
4
5# Talk to a model
6interaction = client.interactions.create(
7    model="gemini-3.5-flash",
8    input="Explain quantum entanglement simply.",
9)
10
11# Run an agent
12interaction = client.interactions.create(
13    agent="antigravity-preview-05-2026",
14    input="Plot the growth of solar energy generation globally and make some slides in HTML.",
15    environment="remote",
16)

Aralık ayından bu yana önemli güncellemeler

• Managed Agents: Tek bir API çağrısı, bir ajanın akıl yürütebileceği, kod çalıştırabileceği, web'de gezinebileceği ve dosyaları yönetebileceği uzak bir Linux sandbox'ı sağlar. Antigravity ajanı varsayılan olarak gelir ve talimatlar, beceriler ve veri kaynaklarıyla kendi özel ajanlarınızı tanımlayabilirsiniz.
• Arka plan yürütme: Herhangi bir çağrıda background=True olarak ayarlayın. Sunucu etkileşimi eşzamansız olarak çalıştırır.
• Araç iyileştirmeleri: Google Search, Google Maps gibi yerleşik araçları, kendi fonksiyonlarınızla tek bir istekte birleştirin. Araç sonuçları artık metnin yanında görseller de döndürebilir.
• Deep Research iyileştirmeleri: İki yeni ajan sürümü (hız vs. derinlik), işbirlikçi planlama, yerel grafikler ve infografikler ve görseller, PDF'ler ve ses ile çok modlu grounding.
• Medya oluşturma: Nano Banana 2 ve Google Image Search grounding ile görsel oluşturma, Lyria 3 ile müzik ve çok konuşmacılı TTS ile anlamlı konuşma.
• Rollerden Adımlara: Her eylemin (user_input, thought, function_call, model_output, vb.) kendi yazılı adımı olduğu basitleştirilmiş şema, eski rol yapısının yerini alıyor.
• Maliyet ve geliştirici optimizasyonları: Flex ve Priority katmanları maliyet veya gecikme süresine göre optimize etmenize olanak tanır (Flex, %50 maliyet düşüşü sunar). Hatalar artık tam alanı belirtiyor. Geçmiş etkileşimler, ücretli katmanda 55 günlük saklama süresiyle alınabilir.

Geliştirme için yeni standart

Interactions API artık Google AI Studio, Gemini API ve tüm dokümantasyonumuz için varsayılandır ve bu dokümantasyon, snippet'leri eski formata döndürmek için bir geçiş anahtarı içerir. Tüm yeni projeler ve uygulamalar için Interactions API'yi kullanmanızı öneririz.

Eski generateContent API'si tam olarak desteklenmeye devam ederken ve öngörülebilir gelecekte yeni ana akım Gemini modellerini almaya devam edecekken, uzun süre çalışan modeller ve ajanlar için sınır yeteneklerinin giderek yalnızca Interactions API'ye geleceğini öngörüyoruz. Bunun nedeni, API'nin en başından itibaren durum bilgisi olan, ajan odaklı iş akışları için tasarlanmış olmasıdır. Kendi hızınızda geçiş yapmanıza yardımcı olması için bir migrasyon kılavuzu yayınladık.

Ajan öncelikli bir ekosistem

Geliştiricilerin çoğu artık uygulama oluşturmak için kodlama ajanlarını (Antigravity gibi) kullanıyor. Ajanların en son API kalıplarıyla güncel kalmasını kolaylaştırmak için gemini-interactions-api Skill'ini oluşturduk. Bu beceri, Interactions API geliştirme için en iyi uygulama kalıplarını ajanınızın bağlamına enjekte eder (streaming, fonksiyon çağırma, yapılandırılmış çıktı, Deep Research ve daha fazlası).

1npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

Başlarken

Interactions API, Python ve JavaScript SDK'ları aracılığıyla kullanılabilir. Desteklenen ortaklarımızdan LiteLLM, Eigent veya Agno ile zaten geliştirme yapıyorsanız, bugün itibarıyla Interactions API entegrasyonlarını kullanmaya başlayabilirsiniz.

API anahtarınızı Google AI Studio'dan alın ve başlamak için Interactions API dokümantasyonunu takip edin. generateContent'ten geçiş yapıyorsanız, migrasyon kılavuzumuz her alanı yeni şemaya eşler. Tam OpenAPI spesifikasyonunu da görüntüleyebilirsiniz.

Interactions API, geliştirici geri bildirimlerine dayanarak oluşturuldu ve bu odak, genel kullanıma sunulmasıyla değişmeyecek. Bize ihtiyaçlarınızı geliştirici forumunda anlatın.