GenerateContentResponse

Antwort des Modells, die mehrere Kandidaten unterstützt.

Hinweis zu Sicherheitsbewertungen und Filtern von Inhalten. Sie werden sowohl für die Aufforderung in GenerateContentResponse.prompt_feedback als auch für jeden Kandidaten in finishReason und safetyRatings gemeldet. Im API-Vertrag gilt Folgendes: – Es werden entweder alle angeforderten Kandidaten zurückgegeben oder gar keine Kandidaten – es werden nur dann keine Kandidaten zurückgegeben, wenn ein Fehler mit dem Prompt vorliegt (siehe promptFeedback) – Feedback zu jedem Kandidaten wird unter finishReason und safetyRatings gemeldet.

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

object (Candidate)

Mögliche Antworten aus dem Modell.
promptFeedback

object (PromptFeedback)

Gibt das Feedback des Prompts in Bezug auf die Inhaltsfilter zurück.
usageMetadata

object (UsageMetadata)

Nur Ausgabe. Metadaten zur Tokennutzung der Generierungsanfragen.

Kandidat

Ein aus dem 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 die Tokens.
safetyRatings[]

object (SafetyRating)

Liste der Bewertungen für die Sicherheit eines Antwortkandidaten.

Es gibt maximal eine Bewertung pro Kategorie.
citationMetadata

object (CitationMetadata)

Nur Ausgabe. Zitatinformationen für einen von einem Modell generierten Kandidaten.

Dieses Feld kann mit Informationen für jeden Text im content gefüllt werden. Dies sind Passagen, die aus urheberrechtlich geschütztem Material in den Trainingsdaten des Grundlagen-LLM „abgegeben“ werden.
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 Haltepunkt des Modells oder angegebene Stoppsequenz.
MAX_TOKENS Die in der Anfrage angegebene maximale Anzahl von Tokens wurde erreicht.
SAFETY Der Inhalt des Kandidaten wurde aus Sicherheitsgründen gemeldet.
RECITATION Der Inhalt des Kandidaten wurde wegen Rezitierungsgründen gekennzeichnet.
OTHER Unbekannter Grund.

SafetyRating

Sicherheitsbewertung für einen Inhalt.

Die Sicherheitsbewertung enthält die Kategorie des Schadens und das Schweregrad der Schadenswahrscheinlichkeit in dieser Kategorie für einen Inhalt. Inhalte sind sicherheitshalber anhand verschiedener Kategorien von Schäden eingestuft und die Wahrscheinlichkeit der Klassifizierung ist hier aufgeführt.

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

enum (HarmCategory)

Erforderlich. Die Kategorie dieser Bewertung.
probability

enum (HarmProbability)

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

boolean

Wurde dieser Inhalt aufgrund dieser Bewertung blockiert?

HarmProbability

Die Wahrscheinlichkeit, dass ein Inhalt schädlich ist.

Das Klassifizierungssystem gibt an, mit welcher Wahrscheinlichkeit Inhalte als unsicher eingestuft werden. Sie gibt jedoch nicht an, wie schwer ein Schaden für einen bestimmten Inhalt ist.

Enums
HARM_PROBABILITY_UNSPECIFIED Wahrscheinlichkeit ist nicht angegeben.
NEGLIGIBLE Inhalte sind höchstwahrscheinlich nicht sicher.
LOW Es ist unwahrscheinlich, dass Inhalte unsicher sind.
MEDIUM Bei Inhalten besteht eine mittlere Wahrscheinlichkeit, dass sie unsicher sind.
HIGH Inhalte sind mit hoher Wahrscheinlichkeit unsicher.

CitationMetadata

Eine Sammlung von Quellenzuordnungen für einen Inhalt.

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

object (CitationSource)

Zitationen von Quellen für eine bestimmte Antwort.

CitationSource

Die Zitation einer Quelle für einen Teil einer bestimmten 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 Beginn des Segments in Byte an.
endIndex

integer

Optional. Ende des zugeordneten Segments, exklusiv.
uri

string

Optional. URI, der für einen Teil des Textes als Quelle zugeordnet ist.
license

string

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

Für Codezitate sind Lizenzinformationen erforderlich.

PromptFeedback

Ein Satz der Feedback-Metadaten, die der in GenerateContentRequest.content angegebene Prompt enthält.

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

enum (BlockReason)

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

object (SafetyRating)

Bewertungen zur Sicherheit des Prompts. Es gibt maximal eine Bewertung pro Kategorie.

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. Du kannst safetyRatings prüfen, um herauszufinden, welche Sicherheitskategorie es 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 in der Aufforderung. Wenn „cacheContent“ festgelegt ist, ist dies immer noch die effektive Gesamtgröße des Prompts. Dies schließt die Anzahl der Tokens im Cache-Inhalt ein.
candidatesTokenCount

integer

Gesamtzahl der Tokens für die generierten Kandidaten.
totalTokenCount

integer

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