GenerateContentResponse

Modelin birden çok adayı destekleyen yanıtı.

Güvenlik derecelendirmeleri ve içerik filtrelemeyle ilgili not. Bunlar hem GenerateContentResponse.prompt_feedback içindeki istem hem de finishReason ve safetyRatings kapsamındaki her aday için raporlanır. API sözleşmesine göre: İstenen tüm adaylar döndürülür veya hiç aday döndürülmez. Yalnızca istemle ilgili bir sorun oluştuğunda (bkz. promptFeedback) hiçbir aday döndürülmez. Her adayla ilgili geri bildirim finishReason ve safetyRatings tarihinde bildirilir.

JSON gösterimi 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
Alanlar
candidates[]

object (Candidate)

Modelden Aday yanıtları.
promptFeedback

object (PromptFeedback)

İstemin içerik filtreleriyle ilgili geri bildirimini döndürür.
usageMetadata

object (UsageMetadata)

Yalnızca çıkış. Oluşturma isteklerinin jeton kullanımıyla ilgili meta veriler.

Aday

Modelden oluşturulan bir yanıt adayı.

JSON gösterimi 
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Alanlar
content

object (Content)

Yalnızca çıkış. Modelden döndürülen, üretilen içerik.
finishReason

enum (FinishReason)

İsteğe bağlı. Yalnızca çıkış. Modelin jeton oluşturmayı durdurmasının nedeni.

Boşsa model, jetonları oluşturmayı durdurmamıştır.
safetyRatings[]

object (SafetyRating)

Bir yanıt adayının güvenliğiyle ilgili derecelendirme listesi.

Kategori başına en fazla bir derecelendirme vardır.
citationMetadata

object (CitationMetadata)

Yalnızca çıkış. Model tarafından oluşturulan adayın alıntı bilgileri.

Bu alan, content kapsamında yer alan herhangi bir metin için alıntı bilgileriyle doldurulabilir. Bunlar, temel LLM'nin eğitim verilerindeki telif hakkıyla korunan materyallerden"okunan" pasajlardır.
tokenCount

integer

Yalnızca çıkış. Bu aday için jeton sayısı.
index

integer

Yalnızca çıkış. Aday listesindeki adayın dizini.

FinishReason

Modelin jeton oluşturmayı durdurma nedenini tanımlar.

Sıralamalar
FINISH_REASON_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
STOP Modelin doğal durma noktası veya sağlanan durdurma sırası.
MAX_TOKENS İstekte belirtilen maksimum jeton sayısına ulaşıldı.
SAFETY Aday içeriği, güvenlik nedeniyle işaretlendi.
RECITATION Aday içeriği, hatırlatma nedeniyle işaretlendi.
OTHER Bilinmeyen neden.

SafetyRating

Bir içerik için güvenlik derecelendirmesi.

Güvenlik derecelendirmesi, bir içeriğin zarar kategorisini ve o kategorideki zarar olasılığı düzeyini içerir. İçerik çeşitli zarar kategorilerinde güvenlik için sınıflandırılır ve zararın zarar görmesi olasılığı sınıflandırması burada yer alır.

JSON gösterimi 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Alanlar
category

enum (HarmCategory)

Zorunlu. Bu puanın kategorisi.
probability

enum (HarmProbability)

Zorunlu. Bu içeriğin zarar görme olasılığı
blocked

boolean

Bu içerik, bu derecelendirme nedeniyle mi engellendi?

HarmProbability

Bir içeriğin zararlı olma olasılığıdır.

Sınıflandırma sistemi, içeriğin güvenli olmama olasılığını verir. Bu, içerikte verilen zararın ciddiyetini belirtmez.

Sıralamalar
HARM_PROBABILITY_UNSPECIFIED Olasılık belirtilmemiş.
NEGLIGIBLE İçeriğin güvensiz olma olasılığı çok azdır.
LOW İçeriğin güvenli olmama olasılığı düşüktür.
MEDIUM İçeriğin güvenli olmama olasılığı orta düzeyde.
HIGH İçeriğin güvenli olmama olasılığı yüksek.

CitationMetadata

Bir içeriğin parçasıyla ilgili kaynak atıfları koleksiyonu.

JSON gösterimi 
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Alanlar
citationSources[]

object (CitationSource)

Belirli bir yanıtın kaynaklarına yapılan alıntılar.

CitationSource

Belirli bir yanıtın bir kısmı için kaynaktan yapılan alıntı.

JSON gösterimi 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Alanlar
startIndex

integer

İsteğe bağlı. Bu kaynakla ilişkilendirilen yanıt segmentinin başlangıcı.

Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.
endIndex

integer

İsteğe bağlı. İlişkilendirilen segmentin sonu (hariç).
uri

string

İsteğe bağlı. Metnin bir bölümü için kaynak olarak ilişkilendirilen URI.
license

string

İsteğe bağlı. Segmentin kaynağı olarak ilişkilendirilen GitHub projesinin lisansı.

Kod alıntıları için lisans bilgisi gereklidir.

PromptFeedback

İstemin GenerateContentRequest.content içinde belirttiği geri bildirim meta veri grubu.

JSON gösterimi 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Alanlar
blockReason

enum (BlockReason)

İsteğe bağlı. Ayarlanırsa istem engellenir ve hiçbir öneri döndürülmez. İsteminizi farklı şekilde ifade edin.
safetyRatings[]

object (SafetyRating)

İstemin güvenliğiyle ilgili derecelendirmeler. Kategori başına en fazla bir derecelendirme vardır.

BlockReason

İstemin engellenmesinin nedenini belirtir.

Sıralamalar
BLOCK_REASON_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
SAFETY İstem, güvenlik nedeniyle engellendi. safetyRatings uygulamasını inceleyerek hangi güvenlik kategorisinin engellediğini öğrenebilirsiniz.
OTHER Bilinmeyen nedenlerden dolayı istem engellendi.

UsageMetadata

Oluşturma isteğinin jeton kullanımıyla ilgili meta veriler.

JSON gösterimi 
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
Alanlar
promptTokenCount

integer

İstemdeki jeton sayısı. Önbelleğe alınmışContent ayarlandığında bu, yine de toplam etkili istem boyutudur. Örneğin, önbelleğe alınmış içerikteki jeton sayısı da buna dahildir.
candidatesTokenCount

integer

Oluşturulan adaylar genelindeki toplam jeton sayısı.
totalTokenCount

integer

Oluşturma isteği (istem + adaylar) için toplam jeton sayısı.