支持多个候选项的模型的响应。
关于安全分级和内容过滤的注意事项。系统会针对 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, "candidatesTokenCount": integer, "totalTokenCount": integer } |
字段 | |
---|---|
promptTokenCount |
提示中的令牌数量。 |
candidatesTokenCount |
所生成的候选词元的总数。 |
totalTokenCount |
生成请求(提示 + 候选项)的令牌总数。 |