- Representación JSON
- Candidato
- FinishReason
- SafetyRating
- HarmProbability
- CitationMetadata
- CitationSource
- PromptFeedback
- BlockReason
- UsageMetadata
Respuesta del modelo que admite varios candidatos.
Nota sobre las clasificaciones de seguridad y los filtros de contenido. Se informan para la instrucción en GenerateContentResponse.prompt_feedback
y para cada candidato en finishReason
y en safetyRatings
. El contrato de la API es el siguiente: - Se muestran todos los candidatos solicitados o ninguno - no se muestra ningún candidato solo si hubo algún problema con la instrucción (consulta promptFeedback
) - Los comentarios sobre cada candidato se informan en finishReason
y safetyRatings
Representación JSON |
---|
{ "candidates": [ { object ( |
Campos | |
---|---|
candidates[] |
Respuestas de los candidatos del modelo. |
promptFeedback |
Muestra los comentarios de la instrucción relacionados con los filtros de contenido. |
usageMetadata |
Solo salida. Metadatos sobre el uso del token de las solicitudes de generación. |
Candidato
Un candidato de respuesta generado a partir del modelo.
Representación JSON |
---|
{ "content": { object ( |
Campos | |
---|---|
content |
Solo salida. Contenido generado que muestra el modelo. |
finishReason |
Opcional. Solo salida. El motivo por el que el modelo dejó de generar tokens. Si está vacío, el modelo no dejó de generar los tokens. |
safetyRatings[] |
Lista de calificaciones sobre la seguridad de un candidato para responder. Existe, como máximo, una calificación por categoría. |
citationMetadata |
Solo salida. Información de citas del candidato generado por el modelo. Este campo puede completarse con información de recitación para cualquier texto incluido en |
tokenCount |
Solo salida. Recuento de tokens para esta variante. |
index |
Solo salida. Índice del candidato en la lista de candidatos. |
FinishReason
Define el motivo por el que el modelo dejó de generar tokens.
Enumeradores | |
---|---|
FINISH_REASON_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
STOP |
Punto de parada natural del modelo o secuencia de parada proporcionada. |
MAX_TOKENS |
Se alcanzó la cantidad máxima de tokens especificado en la solicitud. |
SAFETY |
El contenido del candidato se marcó por motivos de seguridad. |
RECITATION |
El contenido de los candidatos se marcó por motivos de recitación. |
OTHER |
Motivo desconocido. |
SafetyRating
Es la clasificación de seguridad de un contenido.
La clasificación de seguridad incluye la categoría de daño y el nivel de probabilidad de daño para un contenido. El contenido se clasifica en función de la seguridad en una serie de categorías de daño, y aquí se incluye la probabilidad de que se clasifique.
Representación JSON |
---|
{ "category": enum ( |
Campos | |
---|---|
category |
Obligatorio. La categoría de esta calificación. |
probability |
Obligatorio. Indica la probabilidad de daño a este contenido. |
blocked |
¿Este contenido está bloqueado debido a esta clasificación? |
HarmProbability
Es la probabilidad de que un contenido sea dañino.
El sistema de clasificación indica la probabilidad de que el contenido no sea seguro. Esto no indica la gravedad del daño que causa el contenido.
Enumeradores | |
---|---|
HARM_PROBABILITY_UNSPECIFIED |
La probabilidad no se especifica. |
NEGLIGIBLE |
El contenido tiene pocas probabilidades de ser inseguro. |
LOW |
Hay pocas probabilidades de que el contenido no sea seguro. |
MEDIUM |
Es probable que el contenido no sea seguro. |
HIGH |
Es muy probable que el contenido no sea seguro. |
CitationMetadata
Es una colección de atribuciones fuente para un contenido.
Representación JSON |
---|
{
"citationSources": [
{
object ( |
Campos | |
---|---|
citationSources[] |
Citas a las fuentes de una respuesta específica. |
CitationSource
Una cita a una fuente que corresponde a una parte de una respuesta específica.
Representación JSON |
---|
{ "startIndex": integer, "endIndex": integer, "uri": string, "license": string } |
Campos | |
---|---|
startIndex |
Opcional. Inicio del segmento de la respuesta atribuida a esta fuente. El índice indica el inicio del segmento, medido en bytes. |
endIndex |
Opcional. Fin del segmento atribuido, exclusivo. |
uri |
Opcional. Es el URI que se atribuye como fuente de una parte del texto. |
license |
Opcional. Licencia para el proyecto de GitHub que se atribuye como fuente del segmento. Se requiere información de licencia para las citas de código. |
PromptFeedback
Un conjunto de metadatos de comentarios que la instrucción especificó en GenerateContentRequest.content
.
Representación JSON |
---|
{ "blockReason": enum ( |
Campos | |
---|---|
blockReason |
Opcional. Si se establece, se bloqueó el mensaje y no se muestran candidatos. Reformula tu instrucción. |
safetyRatings[] |
Calificaciones de seguridad de la instrucción. Existe, como máximo, una calificación por categoría. |
BlockReason
Especifica el motivo por el que se bloqueó la instrucción.
Enumeradores | |
---|---|
BLOCK_REASON_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
SAFETY |
Se bloqueó el mensaje por razones de seguridad. Puedes inspeccionar safetyRatings para comprender qué categoría de seguridad lo bloqueó. |
OTHER |
Se bloqueó el mensaje debido a motivos desconocidos. |
UsageMetadata
Metadatos sobre el uso del token de la solicitud de generación.
Representación JSON |
---|
{ "promptTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
Campos | |
---|---|
promptTokenCount |
Cantidad de tokens en el mensaje. |
candidatesTokenCount |
Cantidad total de tokens entre los candidatos generados. |
totalTokenCount |
Recuento total de tokens para la solicitud de generación (mensaje + candidatos). |