Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Gemini modelleri için jeton sayma

Gemini modelleri, giriş ve çıkışları parça adı verilen birimler halinde işler.

Parçalar, z gibi tek karakterlerden veya cat gibi tam kelimelerden oluşabilir. Uzun kelimeler birkaç jetona bölünür. Model tarafından kullanılan tüm jetonların kümesine kelime dağarcığı, metni jetonlara bölme işlemine ise jetonlara ayırma denir.

Gemini modellerinde bir jeton yaklaşık 4 karaktere eşdeğerdir. 100 jeton, yaklaşık 60-80 İngilizce kelimeye eşittir.

Her modelin, istem ve yanıtta işleyebileceği maksimum jeton sayısı vardır. İsteminize ait jeton sayısını bilmek, bu sınırı aşıp aşmadığınızı anlamanızı sağlar. Ayrıca, bir isteğin maliyeti kısmen giriş ve çıkış jetonlarının sayısına göre belirlenir. Bu nedenle, jetonların nasıl sayılacağını bilmek faydalı olabilir.

Desteklenen modeller

gemini-4-argon
gemini-3.8-flash
gemini-3.5-flash-lite (ve daha eski gemini-3.1-flash-lite)
gemini-nano-banana-2.1 (Nano Banana 2.1)
gemini-3.1-flash-image (Nano Banana 2)
gemini-3.1-flash-lite-image (Nano Banana 2 Lite)
gemini-3-pro-image (Nano Banana Pro)
gemini-3.1-flash-tts-preview

Eski genel kullanımlı Gemini 3.x Flash ve Gemini 2.5 modelleri bu özelliği destekler ancak yaklaşan kapatma tarihleri ve/veya daha yeni modellere otomatik yönlendirme nedeniyle artık kullanılması önerilmez.

Parça sayma seçenekleri

Gemini API için metin, resim dosyaları ve metin dışı diğer modaliteler dahil olmak üzere tüm giriş ve çıkışlar parçalara ayrılır. Jetonları saymak için kullanabileceğiniz seçenekler şunlardır:

Yalnızca isteklerinizin (modele göndermeden önce) parça sayısını kontrol edin.

İsteği modele göndermeden önce isteğin girişiyle countTokens işlevini çağırın. Bu işlem şunları döndürür:

total_tokens: Yalnızca girişin jeton sayısı

Hem istekleriniz hem de yanıtlarınız için jeton sayısını kontrol edin.

Yanıt nesnesindeki usageMetadata özelliğine erişin. Bu türdeki bilgilere şunlar dahildir:

prompt_token_count: Yalnızca girişin parça sayısı
candidates_token_count: Yalnızca çıkışın jeton sayısı (düşünme jetonlarını içermez)
thoughts_token_count: Yanıtı oluşturmak için kullanılan düşünme token'larının sayısı
total_token_count: hem giriş hem de çıkış için toplam token sayısı (düşünme token'ları dahil)

Çıkış akışı sırasında usageMetadata özelliği yalnızca akışın son parçasında görünür. Ara parçalar için nil değerindedir.

Yukarıdaki seçeneklerle ilgili aşağıdaki noktalara dikkat edin:

Giriş resimlerinin sayısını veya video ya da ses giriş dosyalarındaki saniye sayısını hesaba katmaz. Ancak bu modalitelerin her birinin jeton sayısı, bu değerlerle ilişkili olacaktır.
Giriş parça sayısı, istemin (metin ve giriş dosyaları) yanı sıra sistem talimatlarını ve araçlarını içerir.
Çıkış token'ı sayısı, düşünme token'larını içermez. Bu token'lar ayrı bir alanda sağlanır.
Bu sayfanın ilerleyen kısımlarında yer alan her talep türüne özel ek bilgileri inceleyin.
Gemini Live API modelleri countTokens özelliğini desteklemez. Ayrıca Firebase AI Logic, Live API modellerinden gelen yanıtlarda usageMetadata özelliğini henüz desteklemiyor ancak bu özellik yakında kullanıma sunulacak.

Bu seçeneklerin fiyatlandırması

countTokens çağrısı: countTokens (Count Tokens API) çağrısı için ücret alınmaz. Count Tokens API için maksimum kota, dakikada 3.000 istektir (RPM).
usageMetadata özelliğini kullanma: Bu özellik her zaman yanıtın bir parçası olarak döndürülür ve herhangi bir jeton veya ücret gerektirmez.

Ek bilgiler

Belirli istek türleriyle çalışırken yararlanabileceğiniz bazı ek bilgileri aşağıda bulabilirsiniz.

Metin girişi jetonlarını sayma

Ek bilgi yok.

Çok adımlı (sohbet) parçalarını sayma

Sohbet özelliğini kullanırken countTokens numarasını aramak için aşağıdakilere dikkat edin:

Sohbet geçmişiyle countTokens yöntemini çağırırsanız sohbetteki her iki rolün (total_tokens) toplam parça sayısını döndürür.
Bir sonraki konuşma sıranızın ne kadar büyük olacağını anlamak için countTokens yöntemini çağırırken bu sırayı geçmişe eklemeniz gerekir.

Çok formatlı giriş jetonlarını sayma

Çok formatlı girişle parça sayma hakkında aşağıdaki noktalara dikkat edin:

İsterseniz metin ve dosya için countTokens işlevini ayrı ayrı çağırabilirsiniz.
Her iki jeton sayma seçeneğinde de dosyayı satır içi veri olarak veya URL'sini kullanarak sağladığınızda aynı jeton sayısını elde edersiniz.

Resim giriş dosyaları

Görüntü giriş dosyaları, boyutlarına göre jetonlara dönüştürülür:

Her iki boyutu da 384 pikselden küçük veya bu değere eşit olan resim girişleri: Her resim 258 parça olarak sayılır.
Bir veya her iki boyutta daha büyük olan resim girişleri: Her resim, gerektiğinde 768x768 piksellik parçalara kırpılır ve ölçeklendirilir. Ardından her parça 258 parça olarak sayılır.

Video ve ses giriş dosyaları

Video ve ses giriş dosyaları, aşağıdaki sabit oranlarda jetonlara dönüştürülür:

Video: Saniyede 263 jeton
Ses: Saniyede 32 parça

Doküman (ör. PDF) giriş dosyaları

PDF giriş dosyaları resim olarak değerlendirilir. Bu nedenle, PDF'nin her sayfası bir resimle aynı şekilde parçalanır.