Gemini API'yi kullanarak jeton sayma hakkında ayrıntılı bir kılavuz için (resimler, ses ve videoların nasıl sayıldığı dahil) Jeton sayma kılavuzu'na ve tarif kitabındaki tarife göz atın.
Yöntem: models.countTokens
- Uç nokta
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Örnek istek
- GenerateContentRequest
Bir modelin tokenizörünü Content
girişinde çalıştırır ve jeton sayısını döndürür. Jetonlar hakkında daha fazla bilgi edinmek için jeton kılavuzuna bakın.
Uç nokta
yayınhttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
Yol parametreleri
model
string
Zorunlu. Modelin kaynak adı. Bu, modelin kullanacağı bir kimlik görevi görür.
Bu ad, models.list
yöntemi tarafından döndürülen bir model adıyla eşleşmelidir.
Biçim: models/{model}
models/{model}
biçimindedir.
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
contents[]
object (Content
)
İsteğe bağlı. Modele istem olarak verilen giriş. generateContentRequest
ayarlandığında bu alan yoksayılır.
generateContentRequest
object (GenerateContentRequest
)
İsteğe bağlı. Model
işlevine verilen genel giriş. İstemlerin yanı sıra sistem talimatları ve/veya işlev çağrısı için işlev bildirimleri gibi diğer model yönlendirme bilgileri de buna dahildir. Model
/Content
ve generateContentRequest
birbirini hariç tutar. Model
+ Content
veya generateContentRequest
gönderebilirsiniz ancak ikisini birden gönderemezsiniz.
Örnek istek
Metin
Python
Node.js
Go
kabuk
Kotlin
Swift
Dart
Java
Sohbet
Python
Node.js
Go
kabuk
Kotlin
Swift
Dart
Java
Satır içi medya
Python
Node.js
Go
kabuk
Kotlin
Swift
Dart
Java
Video
Python
Node.js
Go
kabuk
Python
Önbellek
Python
Node.js
Go
Sistem Talimatı
Python
Node.js
Go
Kotlin
Swift
Dart
Java
Araçlar
Python
Node.js
Kotlin
Swift
Dart
Java
Yanıt gövdesi
models.countTokens
tarafından verilen yanıt.
prompt
için modelin tokenCount
değerini döndürür.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
totalTokens
integer
Model
'ın prompt
'u parçalara ayırdığı jeton sayısı. Her zaman pozitiftir.
cachedContentTokenCount
integer
İstemdeki önbelleğe alınmış kısımdaki (önbelleğe alınmış içerik) jeton sayısı.
promptTokensDetails[]
object (ModalityTokenCount
)
Yalnızca çıkış. İstek girişinde işlenen modalitelerin listesi.
JSON gösterimi |
---|
{
"totalTokens": integer,
"cachedContentTokenCount": integer,
"promptTokensDetails": [
{
object ( |
GenerateContentRequest
Modelden bir tamamlama oluşturma isteği.
model
string
Zorunlu. Tamamlamayı oluşturmak için kullanılacak Model
öğesinin adı.
Biçim: models/{model}
.
tools[]
object (Tool
)
İsteğe bağlı. Model
'un sonraki yanıtı oluşturmak için kullanabileceği Tools
öğelerinin listesi.
Tool
, sistemin Model
'ın bilgisi ve kapsamı dışında bir işlem veya işlem grubu gerçekleştirmek için harici sistemlerle etkileşim kurmasını sağlayan bir kod parçasıdır. Desteklenen Tool
değerleri Function
ve codeExecution
'dir. Daha fazla bilgi edinmek için İşlev çağırma ve Kod yürütme kılavuzlarına bakın.
toolConfig
object (ToolConfig
)
İsteğe bağlı. İstekte belirtilen tüm Tool
için araç yapılandırması. Kullanım örneği için İşlev çağırma kılavuzuna bakın.
safetySettings[]
object (SafetySetting
)
İsteğe bağlı. Güvenli olmayan içeriği engellemek için kullanılan benzersiz SafetySetting
örnekleri listesi.
Bu durum GenerateContentRequest.contents
ve GenerateContentResponse.candidates
için geçerli olacaktır. Her SafetyCategory
türü için birden fazla ayar olmamalıdır. API, bu ayarlar tarafından belirlenen eşikleri karşılamayan tüm içerikleri ve yanıtları engeller. Bu liste, safetySettings içinde belirtilen her SafetyCategory
için varsayılan ayarları geçersiz kılar. Listede belirli bir SafetyCategory
için SafetySetting
sağlanmamışsa API, söz konusu kategorinin varsayılan güvenlik ayarını kullanır. HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT, HARM_CATEGORY_CIVIC_INTEGRITY zarar kategorileri desteklenir. Kullanılabilir güvenlik ayarlarıyla ilgili ayrıntılı bilgi için kılavuza göz atın. Yapay zeka uygulamalarınıza güvenlikle ilgili hususları nasıl dahil edeceğinizi öğrenmek için Güvenlik kılavuzu'na da göz atın.
systemInstruction
object (Content
)
İsteğe bağlı. Geliştirici sistem talimatlarını belirler. Şu anda yalnızca metin olarak kullanılabilir.
generationConfig
object (GenerationConfig
)
İsteğe bağlı. Model oluşturma ve çıkışlar için yapılandırma seçenekleri.
cachedContent
string
İsteğe bağlı. Tahmini sunmak için bağlam olarak kullanmak üzere önbelleğe alınan içeriğin adı. Biçim: cachedContents/{cachedContent}
JSON gösterimi |
---|
{ "model": string, "contents": [ { object ( |