- Rappresentazione JSON
- Candidato
- FinishReason
- SafetyRating
- HarmProbability
- CitationMetadata
- CitationSource
- PromptFeedback
- BlockReason
- UsageMetadata
Risposta del modello che supporta più candidati.
Nota sulle classificazioni della sicurezza e sul filtro dei contenuti. Sono riportate sia per la richiesta in GenerateContentResponse.prompt_feedback
che per ogni candidato in finishReason
e in safetyRatings
. Il contratto relativo all'API è il seguente: - vengono restituiti tutti i candidati richiesti o nessun candidato - nessun candidato viene restituito solo se si è verificato un problema con la richiesta (vedi promptFeedback
). I feedback relativi a ogni candidato vengono segnalati in data finishReason
e safetyRatings
.
Rappresentazione JSON |
---|
{ "candidates": [ { object ( |
Campi | |
---|---|
candidates[] |
Risposte dei candidati del modello. |
promptFeedback |
Restituisce il feedback del prompt relativo ai filtri per i contenuti. |
usageMetadata |
Solo output. Metadati sull'utilizzo dei token delle richieste di generazione. |
Candidato
Un candidato per la risposta generato dal modello.
Rappresentazione JSON |
---|
{ "content": { object ( |
Campi | |
---|---|
content |
Solo output. Contenuti generati restituiti dal modello. |
finishReason |
Campo facoltativo. Solo output. Il motivo per cui il modello ha smesso di generare token. Se vuoto, il modello non ha smesso di generare i token. |
safetyRatings[] |
Elenco di classificazioni per la sicurezza di un candidato a una risposta. Esiste al massimo una classificazione per categoria. |
citationMetadata |
Solo output. Informazioni di citazione per il candidato generato dal modello. Questo campo può essere compilato con informazioni sulle citazioni per qualsiasi testo incluso in |
tokenCount |
Solo output. Conteggio dei token per questo candidato. |
index |
Solo output. Indice del candidato nell'elenco dei candidati. |
FinishReason
Definisce il motivo per cui il modello ha smesso di generare token.
Enum | |
---|---|
FINISH_REASON_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
STOP |
Punto di interruzione naturale del modello o sequenza di interruzione fornita. |
MAX_TOKENS |
È stato raggiunto il numero massimo di token specificato nella richiesta. |
SAFETY |
I contenuti dei candidati sono stati segnalati per motivi di sicurezza. |
RECITATION |
I contenuti dei candidati sono stati segnalati per motivi di recitazione. |
OTHER |
Motivo sconosciuto. |
SafetyRating
Valutazione della sicurezza di alcuni contenuti.
La valutazione di sicurezza contiene la categoria di danno e il livello di probabilità di danno in quella categoria per un determinato contenuto. I contenuti sono classificati per sicurezza in base a diverse categorie di danni e la probabilità della classificazione dei contenuti è inclusa qui.
Rappresentazione JSON |
---|
{ "category": enum ( |
Campi | |
---|---|
category |
Obbligatoria. La categoria di questa classificazione. |
probability |
Obbligatoria. La probabilità di danni per questi contenuti. |
blocked |
I contenuti sono stati bloccati a causa della classificazione? |
HarmProbability
La probabilità che un determinato contenuto sia dannoso.
Il sistema di classificazione dà la probabilità che i contenuti non siano sicuri. Ciò non indica la gravità del danno per un determinato contenuto.
Enum | |
---|---|
HARM_PROBABILITY_UNSPECIFIED |
La probabilità non è specificata. |
NEGLIGIBLE |
I contenuti hanno una probabilità trascurabile di non essere sicuri. |
LOW |
I contenuti hanno una bassa probabilità di non essere sicuri. |
MEDIUM |
I contenuti hanno una media probabilità di non essere sicuri. |
HIGH |
I contenuti hanno un'alta probabilità di non essere sicuri. |
CitationMetadata
Una raccolta di attribuzioni della fonte per un contenuto.
Rappresentazione JSON |
---|
{
"citationSources": [
{
object ( |
Campi | |
---|---|
citationSources[] |
Citazioni di fonti per una risposta specifica. |
CitationSource
Una citazione a una fonte per una parte di una risposta specifica.
Rappresentazione JSON |
---|
{ "startIndex": integer, "endIndex": integer, "uri": string, "license": string } |
Campi | |
---|---|
startIndex |
Campo facoltativo. Inizio del segmento della risposta attribuito a questa sorgente. L'indice indica l'inizio del segmento, misurato in byte. |
endIndex |
Campo facoltativo. Fine del segmento attribuito (escluso). |
uri |
Campo facoltativo. URI attribuito come origine per una parte del testo. |
license |
Campo facoltativo. Licenza per il progetto GitHub attribuito come origine del segmento. Le informazioni sulla licenza sono obbligatorie per le citazioni di codici. |
PromptFeedback
Un insieme di metadati dei feedback specificati dal prompt in GenerateContentRequest.content
.
Rappresentazione JSON |
---|
{ "blockReason": enum ( |
Campi | |
---|---|
blockReason |
Campo facoltativo. Se impostato, la richiesta è stata bloccata e non vengono restituiti candidati. Riformula il prompt. |
safetyRatings[] |
Classificazioni per la sicurezza del prompt. Esiste al massimo una classificazione per categoria. |
BlockReason
Specifica il motivo per cui la richiesta è stata bloccata.
Enum | |
---|---|
BLOCK_REASON_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
SAFETY |
Il prompt è stato bloccato per motivi di sicurezza. Puoi controllare safetyRatings per capire da quale categoria di sicurezza è stato bloccato. |
OTHER |
Il prompt è stato bloccato per motivi sconosciuti. |
UsageMetadata
Metadati sull'utilizzo dei token della richiesta di generazione.
Rappresentazione JSON |
---|
{ "promptTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
Campi | |
---|---|
promptTokenCount |
Numero di token nel prompt. Quando è impostata l'impostazione cacheContent, si tratta comunque delle dimensioni effettive totali del prompt. Questo include il numero di token nei contenuti memorizzati nella cache. |
candidatesTokenCount |
Numero totale di token tra i candidati generati. |
totalTokenCount |
Conteggio totale dei token per la richiesta di generazione (prompt + candidati). |