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


Bu sayfada, Live API ve modellerinin kullanımıyla ilgili çeşitli sınırlar ve özellikler 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 hariç), ses, video
    • Çıkış: metin (transkript) ve ses (akış)
  • Desteklenen araçlar: iş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 bir bağlantı üzerinden sürekli olarak aktarıldığı 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çayla sınırlıdır.

    Bu bağlam penceresi sınırı nedeniyle, giriş yöntemlerine göre yaklaşık maksimum oturum uzunlukları aşağıda verilmiştir:

    • Yalnızca ses girişli 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 yaklaşık 60 saniye önce bağlantının kesileceğine dair bir bildirim alırsınız.

Oturumla ilgili sınırları yönetmek için kullanabileceğiniz bazı seçenekler şunlardır:

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

Hız sınırları

Live API, hem Firebase projesi başına eşzamanlı oturumlar hem de dakika başına jeton (TPM) için sıklık 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'da ham 16 bit PCM ses
  • Çıkış ses biçimi: 24 kHz little-endian'da 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 örnek 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ı resim karelerinden oluşan bir dizi bekler ve saniyede 1 kare (FPS) hızında video karesi girişini destekler.

  • Önerilen giriş: 1 FPS'de yerel 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 modelini hızlı sporlarda anlık anlatım gibi hızlı değişen videoların analiz edilmesini gerektiren kullanım alanları için uygunsuz hale getirdiğini unutmayın.

Yanıt sesleri

Live API, her biri farklı ö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 belirteceğinizi öğrenin.

Diller

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

Tüm ses üreten modeller 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 (Güney 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 modelleri tarafından desteklenen 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 İzlandaca :
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 dili mai
Malgaşça mg Malayca ms
Malayalam ml Moğolca mn
Nepalce ne Norveççe, Bokmål nb
Norveççe, Nynorsk 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