GenerateContentResponse

Birden fazla adayı destekleyen modelin yanıtı.

Güvenlik derecelendirmeleri ve içerik filtreleme ile ilgili not. Bunlar hem GenerateContentResponse.prompt_feedback içinde hem de finishReason ve safetyRatings içinde her aday için bildirilir. API sözleşmesine göre: - İstenen tüm adaylar döndürülür ya da hiç aday döndürülmez - hiçbir aday yalnızca istemle ilgili bir sorun olduğunda döndürülmez (bkz. promptFeedback) - her adayla ilgili geri bildirim finishReason ve safetyRatings üzerinden 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, oluşturulmuş içerik.

finishReason

enum (FinishReason)

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

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

safetyRatings[]

object (SafetyRating)

Yanıt adaylarının güvenliğiyle ilgili puan listesi.

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

citationMetadata

object (CitationMetadata)

Yalnızca çıkış. Model tarafından oluşturulan adayla ilgili alıntı bilgileri.

Bu alan, content içindeki herhangi bir metin için alıntı bilgileriyle doldurulabilir. Bunlar, temel LLM'nin eğitim verilerindeki telif hakkıyla korunan materyallerden"alınan" 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, tekrarlama gerekçesiyle işaretlendi.
OTHER Bilinmeyen neden.

SafetyRating

İçerikler için güvenlik derecelendirmesi.

Güvenlik derecelendirmesi, bir içeriğin zarar kategorisini ve o kategorideki zarar verme olasılığı düzeyini içerir. İçerikler çeşitli zarar kategorilerinde güvenlik için sınıflandırılır ve zarar sınıflandırmasının olasılığı buraya dahil edilir.

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 verme olasılığı.

blocked

boolean

Bu içerik, bu derecelendirme nedeniyle mi engellendi?

HarmProbability

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

Sınıflandırma sistemi, içeriğin güvenli olma olasılığını belirtir. Bu, bir içeriğe verilen zararın ciddiyetini göstermez.

Sıralamalar
HARM_PROBABILITY_UNSPECIFIED Olasılık belirtilmedi.
NEGLIGIBLE İçeriğin güvenli olmama olasılığı çok azdır.
LOW İçeriğin güvenli olmama ihtimali düşüktür.
MEDIUM İçeriğin güvenli olmama olasılığı orta düzeydedir.
HIGH İçeriğin güvenli olmama olasılığı yüksektir.

CitationMetadata

Bir içerik için kaynak atıfları koleksiyonu.

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

object (CitationSource)

Belirli bir yanıtla ilgili kaynaklardan 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ı. Segment kaynağı olarak ilişkilendirilen GitHub projesi lisansı.

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

PromptFeedback

İstemin GenerateContentRequest.content politikasında belirtilen geri bildirim meta verileri 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 aday 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 engellenme nedenini belirtir.

Sıralamalar
BLOCK_REASON_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
SAFETY Güvenlik nedeniyle istem engellendi. Hangi güvenlik kategorisinin engellediğini anlamak için safetyRatings aracını inceleyebilirsiniz.
OTHER Bilinmeyen nedenler nedeniyle 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ı.

candidatesTokenCount

integer

Oluşturulan adaylardaki toplam jeton sayısı.

totalTokenCount

integer

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