- JSON 表示法
- PromptFeedbackPromptFeedback
- BlockReason
- UsageMetadata
来自支持多个候选对象的模型的响应。
关于安全评级和内容过滤的注意事项。系统会在 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 |
生成请求的词元总数(提示 + 候选词)。 |