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, resimler (PDF'ler hariç), ses, video
    • Çıkış: metin (transkript) ve ses (yayın)
  • Desteklenen araçlar: İşlev çağrısı, Google Search ile temellendirme, Google Maps ile temellendirme

  • Son güncel bilgi tarihi: Ocak 2025

Live API, yapılandırılmış çıkış (ör. JSON) oluşturmayı veya Count Tokens API'yi 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ı aşağıda verilmiştir:

    • 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:

  • Agent Platform Gemini API (formerly Vertex AI):

    • 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ı belirtmek için her ses içeren 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, 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 Live API'yı uygunsuz hale getirdiğini unutmayın.

Yanıt sesleri

Live API, her biri kendine özgü özelliklere sahip 30 farklı sentezlenmiş HD sesi destekler. Aşağıdaki bölümü genişleterek yanıt sesi seçeneklerinin listesini görüntüleyebilir ve her sesin demosunu dinleyebilirsiniz.

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

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

Diller

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

Tüm ses üretme modelleri tarafından desteklenen diller
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
Ses üreten 3.x modellerinin desteklediği ek diller
Dil BCP-47 kodu Dil BCP-47 kodu
Afrikaanca af Filipince fil
Arnavutça sq Fince fi
Amharca öö Galiçyaca gl
Ermenice hy Gürcüce ka
Azerice az Yunanca el
Baskça eu Gujarati gu
Belarusça be Haiti Creole Dili ht
Bulgarca bg İbranice o
Burmaca benim Macarca hu
Katalanca ca İzlanda dili :
Sabuanca ceb Cava dili jv
Çince, Mandarin cmn Kannada kn
Hırvatça s Konkani kok
Çek dili cs Laoca lo
Danca da Latince la
Estonca et Letonca lv
Litvanca lt Luxembourgish lb
Makedonca mk Maithili mai
Malgaşça mg Malayca ms
Malayalam ml Moğolca mn
Nepalce ne Norveççe, Bokmål nb
Norveççe, Yeni Norveççe nn Oriya veya
Peştuca ps Farsça fa
Punjabi pa Sırpça sr
Sindice sd Seylanca si
Slovakça sk Slovence sl
Swahili sw İsveççe sv
Urduca ur