GenerateContentResponse

Antwort des Modells, das mehrere Kandidaten unterstützt.

Hinweis zu Sicherheitsbewertungen und Filtern von Inhalten. Sie werden sowohl für Aufforderungen in GenerateContentResponse.prompt_feedback als auch für jeden Kandidaten in finishReason und in safetyRatings gemeldet. Der API-Vertrag sieht vor, dass – entweder alle angeforderten Kandidaten oder gar keine Kandidaten zurückgegeben werden – keine Kandidaten nur dann zurückgegeben werden, wenn bei der Eingabe ein Fehler aufgetreten ist (siehe promptFeedback). - Feedback zu jedem Kandidaten wird in finishReason und safetyRatings gemeldet.

JSON-Darstellung 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
Felder
candidates[]

object (Candidate)

Mögliche Antworten des Modells.
promptFeedback

object (PromptFeedback)

Gibt das Feedback der Aufforderung zu den Inhaltsfiltern zurück.
usageMetadata

object (UsageMetadata)

Nur Ausgabe. Metadaten zur Tokennutzung der Generierungsanfragen.

Kandidat

Ein vom Modell generierter Antwortkandidat.

JSON-Darstellung 
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Felder
content

object (Content)

Nur Ausgabe. Generierter Inhalt, der vom Modell zurückgegeben wird.
finishReason

enum (FinishReason)

Optional. Nur Ausgabe. Der Grund, warum das Modell keine Tokens mehr generiert.

Wenn das Feld leer ist, generiert das Modell weiterhin Tokens.
safetyRatings[]

object (SafetyRating)

Liste von Bewertungen für die Sicherheit eines Antwortkandidats.

Pro Kategorie ist maximal eine Bewertung vorhanden.
citationMetadata

object (CitationMetadata)

Nur Ausgabe. Zitationsinformationen für den vom Modell generierten Kandidaten.

Dieses Feld kann mit Vorträgen aus jedem Text aus content gefüllt werden. Diese Abschnitte werden aus urheberrechtlich geschützten Inhalten in den Trainingsdaten des grundlegenden LLM „rezitiert“.
tokenCount

integer

Nur Ausgabe. Tokenanzahl für diesen Kandidaten.
index

integer

Nur Ausgabe. Index des Kandidaten in der Liste der Kandidaten.

FinishReason

Definiert den Grund, warum das Modell keine Tokens mehr generiert.

Enums
FINISH_REASON_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
STOP Natürlicher Stopp des Modells oder angegebene Stoppsequenz.
MAX_TOKENS Die in der Anfrage angegebene maximale Anzahl von Tokens wurde erreicht.
SAFETY Der Inhalt zu dem Kandidaten wurde aus Sicherheitsgründen gemeldet.
RECITATION Die Kandidateninhalte wurden wegen Vorträgen gemeldet.
OTHER Unbekannter Grund.

SafetyRating

Sicherheitsbewertung für einen Inhalt.

Die Sicherheitsbewertung enthält die Kategorie des Schadens und das Schadenswahrscheinlichkeitsniveau in dieser Kategorie für einen Inhalt. Inhalte werden in verschiedenen Schadenskategorien als sicherheitsrelevant eingestuft und die Wahrscheinlichkeit der Klassifizierung ist hier enthalten.

JSON-Darstellung 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Felder
category

enum (HarmCategory)

Erforderlich. Die Kategorie für diese Bewertung.
probability

enum (HarmProbability)

Erforderlich. Die Wahrscheinlichkeit eines Schadens für diesen Inhalt.
blocked

boolean

Wurde dieser Inhalt aufgrund dieser Altersfreigabe blockiert?

HarmProbability

Die Wahrscheinlichkeit, dass ein Inhalt schädlich ist.

Das Klassifizierungssystem gibt die Wahrscheinlichkeit an, dass der Inhalt unsicher ist. Dies gibt nicht an, wie schwerwiegend ein bestimmter Inhalt ist.

Enums
HARM_PROBABILITY_UNSPECIFIED Die Wahrscheinlichkeit ist nicht angegeben.
NEGLIGIBLE Die Wahrscheinlichkeit, dass Inhalte unsicher sind, ist geringfügig.
LOW Die Wahrscheinlichkeit, dass Inhalte nicht sicher sind, ist gering.
MEDIUM Inhalte haben eine mittlere Wahrscheinlichkeit, unsicher zu sein.
HIGH Inhalte haben eine hohe Wahrscheinlichkeit, dass sie unsicher sind.

CitationMetadata

Eine Sammlung von Quellenangaben für einen Inhalt.

JSON-Darstellung 
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Felder
citationSources[]

object (CitationSource)

Zitationen von Quellen für eine bestimmte Antwort

CitationSource

Eine Zitation einer Quelle für einen Teil einer Antwort.

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Felder
startIndex

integer

Optional. Beginn des Segments der Antwort, die dieser Quelle zugeordnet ist.

Der Index gibt den Anfang des Segments in Byte an.
endIndex

integer

Optional. Ende des zugeordneten Segments, exklusiv.
uri

string

Optional. URI, der als Quelle für einen Teil des Texts angegeben wird.
license

string

Optional. Lizenz für das GitHub-Projekt, das als Quelle für das Segment zugeordnet ist.

Für Codezitationen sind Lizenzinformationen erforderlich.

PromptFeedback

Ein Satz der Feedback-Metadaten, die in GenerateContentRequest.content angegeben wurden.

JSON-Darstellung 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Felder
blockReason

enum (BlockReason)

Optional. Wenn festgelegt, wurde der Prompt blockiert und es werden keine Kandidaten zurückgegeben. Formulieren Sie den Prompt um.
safetyRatings[]

object (SafetyRating)

Bewertungen zur Sicherheit der Aufforderung. Pro Kategorie ist maximal eine Bewertung vorhanden.

BlockReason

Gibt an, warum die Aufforderung blockiert wurde.

Enums
BLOCK_REASON_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
SAFETY Die Aufforderung wurde aus Sicherheitsgründen blockiert. Sie können safetyRatings untersuchen, um herauszufinden, welche Sicherheitskategorie sie blockiert hat.
OTHER Die Aufforderung wurde aus unbekannten Gründen blockiert.

UsageMetadata

Metadaten zur Tokennutzung der Generierungsanfrage.

JSON-Darstellung 
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
Felder
promptTokenCount

integer

Anzahl der Tokens im Prompt.
candidatesTokenCount

integer

Gesamtzahl der Tokens für die generierten Kandidaten.
totalTokenCount

integer

Gesamtzahl der Tokens für die Generierungsanfrage (Prompt + Kandidaten).