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)

프롬프트의 안전성을 위한 평점입니다. 카테고리당 최대 1개의 평점이 있습니다.

BlockReason

메시지가 차단된 이유를 지정합니다.

열거형
BLOCK_REASON_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
SAFETY 안전상의 이유로 메시지가 차단되었습니다. safetyRatings를 검사하여 차단된 안전 카테고리를 파악할 수 있습니다.
OTHER 알 수 없는 이유로 메시지가 차단되었습니다.

UsageMetadata

생성 요청의 토큰 사용에 관한 메타데이터입니다.

JSON 표현 
{
  "promptTokenCount": integer,
  "cachedContentTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
입력란
promptTokenCount

integer

프롬프트의 토큰 수입니다. 캐시된Content가 설정되어 있어도 이 값은 여전히 총 유효 프롬프트 크기입니다. 즉, 캐시된 콘텐츠의 토큰 수가 여기에 포함됩니다.
cachedContentTokenCount

integer

프롬프트의 캐시된 부분(즉, 캐시된 콘텐츠의)에 있는 토큰 수입니다.
candidatesTokenCount

integer

생성된 후보의 총 토큰 수입니다.
totalTokenCount

integer

생성 요청의 총 토큰 수입니다 (프롬프트 + 후보).