- Representasi JSON
- Kandidat
- FinishReason
- SafetyRating
- HarmProbability
- CitationMetadata
- CitationSource
- PromptFeedback
- BlockReason
- UsageMetadata
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 ( |
Kolom | |
---|---|
candidates[] |
Respons kandidat dari model. |
promptFeedback |
Menampilkan masukan perintah yang terkait dengan filter konten. |
usageMetadata |
Hanya output. Metadata tentang penggunaan token permintaan pembuatan. |
Kandidat
Kandidat respons yang dibuat dari model.
Representasi JSON |
---|
{ "content": { object ( |
Kolom | |
---|---|
content |
Hanya output. Konten yang dihasilkan yang ditampilkan dari model. |
finishReason |
Opsional. Hanya output. Alasan model berhenti membuat token. Jika kosong, model belum berhenti membuat token. |
safetyRatings[] |
Daftar rating untuk keamanan kandidat respons. Hanya ada satu rating per kategori. |
citationMetadata |
Hanya output. Informasi kutipan untuk kandidat yang dibuat model. Kolom ini dapat diisi dengan informasi kutipan untuk teks apa pun yang disertakan dalam |
tokenCount |
Hanya output. Jumlah token untuk kandidat ini. |
index |
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 ( |
Kolom | |
---|---|
category |
Wajib. Kategori untuk rating ini. |
probability |
Wajib. Probabilitas bahaya untuk konten ini. |
blocked |
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 ( |
Kolom | |
---|---|
citationSources[] |
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 |
Opsional. Awal segmen respons yang diatribusikan ke sumber ini. Indeks menunjukkan awal segmen, yang diukur dalam byte. |
endIndex |
Opsional. Akhir dari segmen yang diatribusikan, eksklusif. |
uri |
Opsional. URI yang diatribusikan sebagai sumber untuk sebagian teks. |
license |
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 ( |
Kolom | |
---|---|
blockReason |
Opsional. Jika disetel, perintah akan diblokir dan tidak ada kandidat yang ditampilkan. Menyusun ulang perintah. |
safetyRatings[] |
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 |
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 |
Jumlah total token di seluruh kandidat yang dibuat. |
totalTokenCount |
Total jumlah token untuk permintaan pembuatan (dialog + kandidat). |