Resposta do modelo que oferece suporte a vários candidatos.
Observação sobre as classificações de segurança e a filtragem de conteúdo. Eles são informados para o comando em GenerateContentResponse.prompt_feedback
e para cada candidato em finishReason
e em safetyRatings
. O contrato da API determina que: todos os candidatos solicitados são devolvidos ou nenhum candidato é retornado; nenhum candidato é retornado apenas se houver algo de errado com a solicitação (consulte promptFeedback
); o feedback sobre cada candidato é informado em finishReason
e safetyRatings
.
Representação JSON |
---|
{ "candidates": [ { object ( |
Campos | |
---|---|
candidates[] |
Respostas dos candidatos do modelo. |
promptFeedback |
Retorna o feedback do comando relacionado aos filtros de conteúdo. |
usageMetadata |
Apenas saída. Metadados sobre o uso do token das solicitações de geração. |
PromptFeedback
Um conjunto de metadados de feedback do comando especificado em GenerateContentRequest.content
.
Representação JSON |
---|
{ "blockReason": enum ( |
Campos | |
---|---|
blockReason |
Opcional. Se definido, a solicitação será bloqueada e nenhum candidato será retornado. Reformule seu comando. |
safetyRatings[] |
Classificações para segurança do comando. Existe no máximo uma classificação por categoria. |
BlockReason
Especifica o motivo do bloqueio da solicitação.
Tipos enumerados | |
---|---|
BLOCK_REASON_UNSPECIFIED |
Valor padrão. Esse valor não é usado. |
SAFETY |
O comando foi bloqueado por motivos de segurança. Inspecione o safetyRatings para entender qual categoria de segurança o bloqueou. |
OTHER |
A solicitação foi bloqueada por motivos desconhecidos. |
UsageMetadata
Metadados sobre o uso do token da solicitação de geração.
Representação JSON |
---|
{ "promptTokenCount": integer, "cachedContentTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
Campos | |
---|---|
promptTokenCount |
Número de tokens no comando. Quando cacheContent é definido, esse ainda é o tamanho total efetivo da solicitação. Ou seja, isso inclui o número de tokens no conteúdo armazenado em cache. |
cachedContentTokenCount |
Número de tokens na parte armazenada em cache do comando, ou seja, no conteúdo armazenado em cache. |
candidatesTokenCount |
Número total de tokens nos candidatos gerados. |
totalTokenCount |
Contagem total de tokens para a solicitação de geração (comando + candidatos). |