- JSON-Darstellung
- Kandidat
- FinishReason
- SafetyRating
- HarmProbability
- CitationMetadata
- CitationSource
- PromptFeedback
- BlockReason
- UsageMetadata
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 ( |
Felder | |
---|---|
candidates[] |
Mögliche Antworten aus dem Modell. |
promptFeedback |
Gibt das Feedback des Prompts in Bezug auf die Inhaltsfilter zurück. |
usageMetadata |
Nur Ausgabe. Metadaten zur Tokennutzung der Generierungsanfragen. |
Kandidat
Ein aus dem Modell generierter Antwortkandidat.
JSON-Darstellung |
---|
{ "content": { object ( |
Felder | |
---|---|
content |
Nur Ausgabe. Generierter Inhalt, der vom Modell zurückgegeben wird. |
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[] |
Liste der Bewertungen für die Sicherheit eines Antwortkandidaten. Es gibt maximal eine Bewertung pro Kategorie. |
citationMetadata |
Nur Ausgabe. Zitatinformationen für einen von einem Modell generierten Kandidaten. Dieses Feld kann mit Informationen für jeden Text im |
tokenCount |
Nur Ausgabe. Tokenanzahl für diesen Kandidaten. |
index |
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 ( |
Felder | |
---|---|
category |
Erforderlich. Die Kategorie dieser Bewertung. |
probability |
Erforderlich. Die Wahrscheinlichkeit eines Schadens für diesen Inhalt. |
blocked |
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 ( |
Felder | |
---|---|
citationSources[] |
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 |
Optional. Beginn des Segments der Antwort, die dieser Quelle zugeordnet ist. Der Index gibt den Beginn des Segments in Byte an. |
endIndex |
Optional. Ende des zugeordneten Segments, exklusiv. |
uri |
Optional. URI, der für einen Teil des Textes als Quelle zugeordnet ist. |
license |
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 ( |
Felder | |
---|---|
blockReason |
Optional. Wenn festgelegt, wurde die Aufforderung blockiert und es werden keine Kandidaten zurückgegeben. Formulieren Sie den Prompt um. |
safetyRatings[] |
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 |
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 |
Gesamtzahl der Tokens für die generierten Kandidaten. |
totalTokenCount |
Gesamtzahl der Tokens für die Generierungsanfrage (Prompt und Kandidaten). |