Gemini modelleri için jeton sayma

Gemini modeller, 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 hazinesi, 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.

Gemini 1.0 ve 1.5 modellerinin de "faturalandırılabilir karakter" sayısı ve fiyatlandırmayı desteklediğini ancak bu modellerin kullanımdan kaldırıldığı veya yakında kaldırılacağını unutmayın. Bu nedenle, bu sayfada faturalandırılabilir karakterlerle ilgili herhangi bir bilgi verilmemektedir.

Desteklenen modeller

  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-2.5-flash-lite-preview-06-17
  • gemini-2.0-flash-001 (ve otomatik olarak güncellenen gemini-2.0-flash takma adı)
  • gemini-2.0-flash-lite-001 (ve otomatik olarak güncellenen diğer adı gemini-2.0-flash-lite)
  • gemini-2.0-flash-preview-image-generation

Jetonları sayma seçenekleri

Gemini API için tüm giriş ve çıkışlar (metin, resim dosyaları ve metin dışı diğer yöntemler dahil) 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 önce isteğin girişini kullanarak
CallcountTokens işlevini çağırın. Bu işlev şu sonucu döndürür:
  • total_tokens: yalnızca girişin jeton sayısı
Hem isteklerinizin hem de yanıtlarınızın jeton sayısını kontrol edin.
Yanıt nesnesinde usageMetadata özelliğini kullanın. Bu kapsamda:
  • 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)

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

Yukarıdaki seçeneklerle ilgili olarak 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 modalitelerin her birinin jeton sayısı bu değerlerle ilişkilendirilir.
  • Giriş jetonu sayısı, istemin (metin ve giriş dosyaları) yanı sıra sistem talimatlarını ve araçlarını da 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.

Bu seçeneklerin fiyatlandırması

  • Çağrı countTokens: countTokens (Count Tokens API) çağrısı için ücret alınmaz. Count Tokens API'nin maksimum kotası 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 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 olarak aşağıdakileri unutmayın:

  • Sohbet geçmişiyle birlikte countTokens işlevini çağırırsanız sohbetteki her iki rolden (total_tokens) 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 metni ve dosyayı ayrı ayrı countTokens ile arayabilirsiniz.
  • 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 384 piksele eşit olan resim girişleri: Her resim 258 jeton olarak sayılır.
  • Bir veya iki boyutta daha büyük olan resim girişleri: Her resim, gerektiği şekilde 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 belirteklere ayrılır.