GenerateContentResponse

Respons dari model yang mendukung beberapa kandidat.

Catatan tentang rating keamanan dan pemfilteran konten. Peristiwa ini dilaporkan untuk perintah di GenerateContentResponse.prompt_feedback dan untuk setiap kandidat di finishReason dan safetyRatings. Kontrak API adalah: - baik semua kandidat yang diminta ditampilkan atau tidak ada kandidat sama sekali - tidak ada kandidat yang ditampilkan hanya jika terdapat masalah dengan perintah (lihat promptFeedback) - masukan terkait setiap kandidat dilaporkan pada finishReason dan safetyRatings.

Representasi JSON
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
Kolom
candidates[]

object (Candidate)

Respons kandidat dari model.

promptFeedback

object (PromptFeedback)

Menampilkan masukan perintah yang terkait dengan filter konten.

usageMetadata

object (UsageMetadata)

Hanya output. Metadata tentang penggunaan token permintaan pembuatan.

Kandidat

Kandidat respons yang dibuat dari model.

Representasi JSON
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Kolom
content

object (Content)

Hanya output. Konten yang dihasilkan yang ditampilkan dari model.

finishReason

enum (FinishReason)

Opsional. Hanya output. Alasan model berhenti membuat token.

Jika kosong, model belum berhenti membuat token.

safetyRatings[]

object (SafetyRating)

Daftar rating untuk keamanan kandidat respons.

Hanya ada satu rating per kategori.

citationMetadata

object (CitationMetadata)

Hanya output. Informasi kutipan untuk kandidat yang dibuat model.

Kolom ini dapat diisi dengan informasi kutipan untuk teks apa pun yang disertakan dalam content. Ini adalah bagian yang "dibaca" dari materi berhak cipta dalam data pelatihan LLM dasar.

tokenCount

integer

Hanya output. Jumlah token untuk kandidat ini.

index

integer

Hanya output. Indeks kandidat dalam daftar kandidat.

FinishReason

Menentukan alasan model berhenti membuat token.

Enum
FINISH_REASON_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
STOP Titik perhentian alami dari model atau urutan perhentian yang diberikan.
MAX_TOKENS Jumlah maksimum token yang ditentukan dalam permintaan telah tercapai.
SAFETY Konten kandidat dilaporkan karena alasan keamanan.
RECITATION Konten kandidat ditandai karena alasan pembacaan.
OTHER Alasan tidak diketahui.

SafetyRating

Rating keamanan untuk suatu konten.

Rating keamanan berisi kategori bahaya dan tingkat probabilitas bahaya dalam kategori tersebut untuk suatu konten. Konten diklasifikasikan demi keamanan di berbagai kategori bahaya dan kemungkinan klasifikasi bahaya akan disertakan di sini.

Representasi JSON
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Kolom
category

enum (HarmCategory)

Wajib. Kategori untuk rating ini.

probability

enum (HarmProbability)

Wajib. Probabilitas bahaya untuk konten ini.

blocked

boolean

Apakah konten ini diblokir karena rating ini?

HarmProbability

Probabilitas bahwa suatu konten berbahaya.

Sistem klasifikasi memberikan probabilitas konten tidak aman. Hal ini tidak menunjukkan tingkat keparahan bahaya untuk suatu konten.

Enum
HARM_PROBABILITY_UNSPECIFIED Probabilitas tidak ditentukan.
NEGLIGIBLE Konten memiliki peluang kecil untuk dianggap tidak aman.
LOW Konten memiliki peluang rendah untuk menjadi tidak aman.
MEDIUM Konten memiliki peluang sedang untuk dianggap tidak aman.
HIGH Konten sangat berisiko menjadi tidak aman.

CitationMetadata

Kumpulan atribusi sumber untuk suatu konten.

Representasi JSON
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Kolom
citationSources[]

object (CitationSource)

Kutipan ke sumber untuk respons tertentu.

CitationSource

Kutipan ke sumber untuk bagian respons tertentu.

Representasi JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Kolom
startIndex

integer

Opsional. Awal segmen respons yang diatribusikan ke sumber ini.

Indeks menunjukkan awal segmen, yang diukur dalam byte.

endIndex

integer

Opsional. Akhir dari segmen yang diatribusikan, eksklusif.

uri

string

Opsional. URI yang diatribusikan sebagai sumber untuk sebagian teks.

license

string

Opsional. Lisensi untuk project GitHub yang diatribusikan sebagai sumber untuk segmen.

Info lisensi diperlukan untuk kutipan kode.

PromptFeedback

Kumpulan metadata masukan dari perintah yang ditentukan di GenerateContentRequest.content.

Representasi JSON
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Kolom
blockReason

enum (BlockReason)

Opsional. Jika disetel, perintah akan diblokir dan tidak ada kandidat yang ditampilkan. Menyusun ulang perintah.

safetyRatings[]

object (SafetyRating)

Rating untuk keamanan dialog. Hanya ada satu rating per kategori.

BlockReason

Menentukan alasan dialog diblokir.

Enum
BLOCK_REASON_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
SAFETY Perintah diblokir karena alasan keamanan. Anda dapat memeriksa safetyRatings untuk memahami kategori keamanan mana yang memblokirnya.
OTHER Perintah diblokir karena alasan yang tidak diketahui.

UsageMetadata

Metadata pada penggunaan token permintaan pembuatan.

Representasi JSON
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
Kolom
promptTokenCount

integer

Jumlah token dalam perintah. Jika cacheContent ditetapkan, ini masih merupakan ukuran perintah total yang efektif. Misalnya, hal ini mencakup jumlah token dalam konten yang di-cache.

candidatesTokenCount

integer

Jumlah total token di seluruh kandidat yang dibuat.

totalTokenCount

integer

Total jumlah token untuk permintaan pembuatan (dialog + kandidat).