GenerateContentResponse

支援多個候選項目的模型回應。

安全評分和內容篩選功能的注意事項。系統會在 GenerateContentResponse.prompt_feedback 中針對每位候選人回報提示，而 finishReason 和 safetyRatings 也會為每位候選人回報。API 合約代表：系統會傳回所有要求的候選人，或是完全不傳回候選人，只有在提示有誤時才會傳回任何候選人 (請參閱 promptFeedback)；各候選人的意見回饋會在 finishReason 和 safetyRatings 上回報。

JSON 表示法 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
欄位
candidates[]

object (Candidate)

模型中的候選回應。
promptFeedback

object (PromptFeedback)

傳回與內容篩選器相關的提示意見回饋。
usageMetadata

object (UsageMetadata)

僅供輸出。產生要求權杖使用情形的中繼資料，

PromptFeedback

GenerateContentRequest.content 中指定提示的一組意見回饋中繼資料。

JSON 表示法 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
欄位
blockReason

enum (BlockReason)

選用設定。如果已設定，系統會封鎖提示，且不會傳回任何候選文字。請修改提示。
safetyRatings[]

object (SafetyRating)

用於確保提示安全性的評分。每個類別最多有一個評分。

BlockReason

說明封鎖提示的原因。

列舉
BLOCK_REASON_UNSPECIFIED 預設值。這個值未使用。
SAFETY 基於安全考量，提示遭到封鎖。您可以查看「safetyRatings」以瞭解哪個安全性類別遭到封鎖。
OTHER 提示因不明原因而遭到封鎖。

UsageMetadata

產生要求權杖用量的中繼資料。

JSON 表示法 
{
  "promptTokenCount": integer,
  "cachedContentTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
欄位
promptTokenCount

integer

提示中的權杖數量。設定 CacheContent 後，這仍是有效提示總大小。亦即快取內容中的權杖數量。
cachedContentTokenCount

integer

提示中快取部分 (例如快取內容) 中的權杖數量。
candidatesTokenCount

integer

所有已產生的候選項目權杖總數。
totalTokenCount

integer

產生要求的符記總數 (提示 + 候選)。