여러 후보를 지원하는 모델의 응답입니다.
안전 등급 및 콘텐츠 필터링에 관한 참고사항 GenerateContentResponse.prompt_feedback
의 프롬프트와 finishReason
및 safetyRatings
의 각 후보에 관해 모두 보고됩니다. API 계약은 다음과 같습니다. - 요청된 모든 후보가 반환되거나 후보가 전혀 없음 - 메시지에 문제가 있는 경우에만 후보가 반환되지 않음 (promptFeedback
참고) - 각 후보에 대한 의견은 finishReason
및 safetyRatings
에 보고됩니다.
JSON 표현 |
---|
{ "candidates": [ { object ( |
입력란 | |
---|---|
candidates[] |
모델의 후보 응답 |
promptFeedback |
콘텐츠 필터와 관련된 프롬프트의 의견을 반환합니다. |
usageMetadata |
출력 전용입니다. 생성 요청의 토큰 사용량에 대한 메타데이터입니다. |
PromptFeedback
GenerateContentRequest.content
에 지정된 프롬프트의 의견 메타데이터 집합입니다.
JSON 표현 |
---|
{ "blockReason": enum ( |
입력란 | |
---|---|
blockReason |
선택사항입니다. 설정된 경우 프롬프트가 차단되고 후보가 반환되지 않습니다. 프롬프트를 변경합니다. |
safetyRatings[] |
메시지 안전을 위한 평점 카테고리당 평점은 최대 1개입니다. |
BlockReason
메시지가 차단된 이유를 지정합니다.
열거형 | |
---|---|
BLOCK_REASON_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
SAFETY |
안전상의 이유로 메시지가 차단되었습니다. safetyRatings 을(를) 검사하여 어느 안전 카테고리를 차단했는지 확인할 수 있습니다. |
OTHER |
알 수 없는 이유로 메시지가 차단되었습니다. |
UsageMetadata
생성 요청의 토큰 사용에 대한 메타데이터입니다.
JSON 표현 |
---|
{ "promptTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
입력란 | |
---|---|
promptTokenCount |
프롬프트의 토큰 수입니다. |
candidatesTokenCount |
생성된 조합의 총 토큰 수입니다. |
totalTokenCount |
생성 요청의 총 토큰 수입니다 (프롬프트 + 후보). |