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

Model updates:

The latest Gemini models, like Gemini 3.8 Flash, are 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-3.8-flash or gemini-3.1-flash-image). 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ışı jeton adı verilen birimler halinde işler.

Jetonlar, z gibi tek karakterler veya cat gibi tam kelimeler olabilir. Uzun kelimeler birkaç jetona ayrılır. Model tarafından kullanılan tüm jetonlar kümesine kelime dağarcığı, metni jetonlara bölme işlemine ise jetonlaştırma adı verilir.

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

Her modelin, istem ve yanıtta işleyebileceği bir maksimum jeton sayısı vardır. İsteminizin 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ı nasıl sayacağınızı bilmek faydalı olabilir.

Desteklenen modeller

gemini-3.1-pro-preview
gemini-3.8-flash (ve daha eski gemini-3.7-flash, gemini-3.6-flash ve gemini-3.5-flash)
gemini-3.5-flash-lite (ve eski gemini-3.1-flash-lite)
gemini-3-pro-image (diğer adıyla "Nano Banana Pro")
gemini-3.1-flash-image (diğer adıyla "Nano Banana 2")
gemini-3.1-flash-lite-image (diğer adıyla "Nano Banana 2 Lite")
gemini-3.1-flash-tts-preview

Genel kullanım ve görüntü oluşturma Gemini 2.5 modelleri bu özelliği destekler ancak tüm bu modellerin desteği sonlandırılmıştır.

Parça sayma seçenekleri

Metin, resim dosyaları ve metin dışı diğer yöntemler de dahil olmak üzere Gemini API ile ilgili tüm giriş ve çıkışlar jetonlaştırılır. Jetonları sayma seçenekleri şunlardır:

Yalnızca istekleriniz için jeton sayısını kontrol edin (modele göndermeden önce).

İsteği modele göndermeden countTokens girişini kullanarak önceden çağırın. Bu işlev şu sonucu döndürür:

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

Hem isteklerinizin hem de yanıtlarınızın jeton sayısını kontrol edin.

Yanıt nesnesinde usageMetadata özelliğine erişin. Bu tür içerikler aşağıdakileri kapsar:

prompt_token_count: Yalnızca girişin jeton sayısı
candidates_token_count: Yalnızca çıkışın jeton sayısı (düşünme jetonları dahil değildir)
thoughts_token_count: Yanıt oluşturmak için kullanılan düşünme jetonlarının sayısı
total_token_count: giriş ve çıkış için toplam jeton sayısı (düşünme jetonları dahil)

Akış çıktısı sırasında usageMetadata özelliği yalnızca akışın son bölümünde görünür. Ara parçalar için nil'dır.

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ı hesaplamazlar. Ancak bu biçimlerin her birindeki jeton sayısı bu değerlerle ilişkilendirilir.
Giriş jetonu sayısı; istemi (metin ve tüm giriş dosyaları) ve sistem talimatları ile araçları içerir.
Çıkış jetonu sayısı, düşünme jetonlarını içermez. Bu jetonlar ayrı bir alanda sağlanır.
Bu sayfanın ilerleyen kısımlarında her istek türüne özel ek bilgileri inceleyin.
Gemini Live API modelleri, countTokens'ü desteklemez. Ayrıca, Firebase AI Logic, Live API modellerinden gelen yanıttaki usageMetadata özelliğini henüz desteklemiyor ancak bu özellik yakında kullanıma sunulacak.

Bu seçeneklerin fiyatlandırması

countTokens (Count Tokens API) çağrısı: countTokens çağrısı için ücret alınmaz. Count Tokens API'nin maksimum kotası dakikada 3.000 istek (RPM) şeklindedir.
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 dikkat etmeniz gereken ek bilgiler aşağıda verilmiştir.

Metin girişi jetonlarını sayma

Ek bilgi yok.

Çok adımlı (sohbet) jetonlarını sayma

Sohbeti kullanırken countTokens araması yapmayla ilgili aşağıdaki noktaları göz önünde bulundurun:

Sohbet geçmişiyle birlikte countTokens işlevini çağırırsanız sohbetteki her iki rolden (total_tokens) gelen toplam jeton sayısını döndürür.
Bir sonraki etkileşiminizin ne kadar büyük olacağını anlamak için countTokens işlevini çağırırken bunu geçmişe eklemeniz gerekir.

Çok formatlı giriş jetonlarını sayma

Çok formatlı girişle jeton sayımı hakkında aşağıdaki noktalara dikkat edin:

İsterseniz metin ve dosya için ayrı ayrı countTokens çağrısı yapabilirsiniz.
Dosyayı satır içi veri olarak veya URL'sini kullanarak göndermeniz fark etmeksizin her iki jeton sayma seçeneğinde de aynı jeton sayısı elde edilir.

Resim giriş dosyaları

Resim 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 jeton olarak sayılır.
Bir veya iki boyutu daha büyük olan resim girişleri: Her resim, gerektiğinde 768x768 piksellik bloklar halinde kırpılır ve ölçeklendirilir. Ardından her blok 258 jeton 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 jeton

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

PDF giriş dosyaları resim olarak değerlendirilir. Bu nedenle, PDF'nin her sayfası resimle aynı şekilde jetonlaştırılır.