Live API'nin sınırları ve spesifikasyonları


Bu sayfada, Live API ve modellerinin kullanımına ilişkin çeşitli sınırlar ve spesifikasyonlar açıklanmaktadır.

Genel spesifikasyonlar ve sınırlar

  • Desteklenen giriş ve çıkış: (Ayrıntılar için aşağıdaki medya biçimleri bölümüne bakın)

    • Giriş: metin, resim (PDF değil), ses, video
    • Çıkış: metin (transkript) ve ses (yayın)

  • Desteklenen araçlar: İşlev çağrısı, Google Search ile temellendirme, Google Maps ile temellendirme

  • Bilgi kesme tarihi: Ocak 2025

Live API, yapılandırılmış çıkış (ör. JSON) veya Count Tokens API oluşturmayı desteklemez.

Oturumla ilgili sınırlar

Live API için oturum, giriş ve çıkışın bağlantı üzerinden sürekli olarak yayınlandığı kalıcı bir bağlantıyı ifade eder.

Oturum aşağıdaki sınırlardan herhangi birini aşarsa bağlantı sonlandırılır. Ancak Live API, oturumla ilgili bu sınırları yönetmek için bazı seçenekler (aşağıya bakın) sunar.

  • Oturum bağlam penceresi 128 bin parça ile sınırlıdır.

    Bu bağlam penceresi sınırı nedeniyle, giriş biçimlerine göre yaklaşık maksimum oturum uzunlukları şunlardır:

    • Yalnızca sesli giriş oturumları 15 dakika ile sınırlıdır.
    • Video ve ses girişi 2 dakika ile sınırlıdır.

  • Bağlantı süresi yaklaşık 10 dakika ile sınırlıdır.

    Bağlantı sona ermeden 60 saniye önce kullanımdan kaldırılma bildirimi alırsınız.

Oturumla ilgili sınırlara yönelik bazı seçenekleri aşağıda bulabilirsiniz:

Oturumları yönetme hakkında daha fazla bilgi edinin.

Hız sınırları

Live API, Firebase projesi başına eşzamanlı oturumlar ve dakikadaki jeton sayısı (TPM) için hız sınırlarına sahiptir.

  • Gemini Developer API:

  • Vertex AI Gemini API:

    • Firebase projesi başına 1.000 eşzamanlı oturum
    • Dakikada 4 milyon jeton

Medya biçimleri

Live API, aşağıdaki medya türlerini destekler:

  • Giriş: resimler, ses, video
  • Çıkış: ses

Resim biçimleri

Live API, resim girişi için aşağıdakileri destekler:

  • İstem başına maksimum resim sayısı: 3.000

  • Dosya başına maksimum dosya boyutu (satır içi veriler): 7 MB

  • Desteklenen MIME türleri: image/png, image/jpeg, image/webp, image/heic, image/heif

Ses biçimleri

Live API aşağıdaki ses biçimlerini destekler:

  • Giriş ses biçimi: 16 kHz little-endian ham 16 bit PCM ses

  • Çıkış ses biçimi: 24 kHz little-endian ham 16 bit PCM ses

  • Desteklenen MIME türleri: audio/x-aac, audio/flac, audio/mp3, audio/m4a, audio/mpeg, audio/mpga, audio/mp4, audio/ogg, audio/pcm, audio/wav, audio/webm

Giriş sesinin örnekleme hızını iletmek için ses içeren her Blob'un MIME türünü audio/pcm;rate=16000 gibi bir değere ayarlayın.

Video biçimleri

Live API, ayrı görüntü kareleri dizisi bekler ve saniyede 1 kare (FPS) hızında video kareleri girişini destekler.

  • Önerilen giriş: 1 FPS'de doğal 768x768 çözünürlük.

  • Desteklenen MIME türleri: video/x-flv, video/quicktime, video/mpeg, video/mpegs, video/mpg, video/mp4, video/webm, video/wmv, video/3gpp

Bu spesifikasyonun, Live API öğesini hızlı değişen videoların analiz edilmesini gerektiren kullanım alanları (ör. yüksek hızlı sporlarda anlık anlatım) için uygunsuz hale getirdiğini unutmayın.

Yanıt sesleri

Live API aşağıdaki yanıt sesi seçeneklerini destekler. Her sesin nasıl duyulduğuyla ilgili demolar için Chirp 3: HD sesler başlıklı makaleyi inceleyin.

Yanıt sesi belirtmezseniz varsayılan olarak Puck kullanılır.

Yanıt sesini nasıl belirleyeceğinizi öğrenin.

Zephyr — Parlak
Kore — Sert
Orus — Sert
Autonoe — Parlak
Umbriel — Rahat
Erinome — Net
Laomedeia — Neşeli
Schedar — Dengeli
Achird — Samimi
Sadachbia — Canlı 		Puck — Enerjik
Fenrir — Heyecanlı
Aoede — Sakin
Enceladus — Fısıltı
Algieba — Akıcı
Algenib — Sert
Achernar — Yumuşak
Gacrux — Olgun
Zubenelgenubi — Rahat
Sadaltager — Bilgili 		Charon — Bilgilendirici
Leda — Genç
Callirrhoe — Rahat
Iapetus — Net
Despina — Akıcı
Rasalgethi — Bilgilendirici
Alnilam — Kararlı
Pulcherrima — İleriye dönük
Vindemiatrix — Nazik
Sulafat — Sıcakkanlı

Diller

Live API aşağıdaki dilleri destekler. Yanıt dilini nasıl etkileyeceğinizi öğrenin.

Dil BCP-47 Kodu Dil BCP-47 Kodu
Arapça (Mısır) ar-EG Almanca (Almanya) de-DE
İngilizce (ABD) tr-TR İspanyolca (ABD) es-US
Fransızca (Fransa) fr-FR Hintçe (Hindistan) hi-IN
Endonezce (Endonezya) id-ID İtalyanca (İtalya) it-IT
Japonca (Japonya) ja-JP Korece (Kore) ko-KR
Portekizce (Brezilya) pt-BR Rusça (Rusya) ru-RU
Felemenkçe (Hollanda) nl-NL Lehçe (Polonya) pl-PL
Tayca (Tayland) th-TH Türkçe (Türkiye) tr-TR
Vietnamca (Vietnam) vi-VN Rumence (Romanya) ro-RO
Ukraynaca (Ukrayna) uk-UA Bengalce (Bangladeş) bn-BD
İngilizce (Hindistan) en-IN ve hi-IN paketi Marathi dili (Hindistan) mr-IN
Tamilce (Hindistan) ta-IN Telugu dili (Hindistan) te-IN