支援多個候選項目的模型回應。
安全評分和內容篩選功能的注意事項。系統會在 GenerateContentResponse.prompt_feedback
中針對每位候選人回報提示,而 finishReason
和 safetyRatings
也會為每位候選人回報。API 合約代表:系統會傳回所有要求的候選人,或是完全不傳回候選人,只有在提示有誤時才會傳回任何候選人 (請參閱 promptFeedback
);各候選人的意見回饋會在 finishReason
和 safetyRatings
上回報。
JSON 表示法 |
---|
{ "candidates": [ { object ( |
欄位 | |
---|---|
candidates[] |
模型中的候選回應。 |
promptFeedback |
傳回與內容篩選器相關的提示意見回饋。 |
usageMetadata |
僅供輸出。產生要求權杖使用情形的中繼資料, |
PromptFeedback
GenerateContentRequest.content
中指定提示的一組意見回饋中繼資料。
JSON 表示法 |
---|
{ "blockReason": enum ( |
欄位 | |
---|---|
blockReason |
選用設定。如果已設定,系統會封鎖提示,且不會傳回任何候選文字。請修改提示。 |
safetyRatings[] |
用於確保提示安全性的評分。每個類別最多有一個評分。 |
BlockReason
說明封鎖提示的原因。
列舉 | |
---|---|
BLOCK_REASON_UNSPECIFIED |
預設值。這個值未使用。 |
SAFETY |
基於安全考量,提示遭到封鎖。您可以查看「safetyRatings 」以瞭解哪個安全性類別遭到封鎖。 |
OTHER |
提示因不明原因而遭到封鎖。 |
UsageMetadata
產生要求權杖用量的中繼資料。
JSON 表示法 |
---|
{ "promptTokenCount": integer, "cachedContentTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
欄位 | |
---|---|
promptTokenCount |
提示中的權杖數量。設定 CacheContent 後,這仍是有效提示總大小。亦即快取內容中的權杖數量。 |
cachedContentTokenCount |
提示中快取部分 (例如快取內容) 中的權杖數量。 |
candidatesTokenCount |
所有已產生的候選項目權杖總數。 |
totalTokenCount |
產生要求的符記總數 (提示 + 候選)。 |