Method: tunedModels.generateContent

Generiert eine Antwort vom Modell auf Basis einer GenerateContentRequest-Eingabe.

HTTP-Anfrage

POST https://generativelanguage.googleapis.com/v1beta/{model=tunedModels/*}:generateContent

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
model

string

Erforderlich. Der Name des Model, der zum Generieren der Vervollständigung verwendet werden soll.

Format: name=models/{model}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  }
}
Felder
contents[]

object (Content)

Erforderlich. Der Inhalt der aktuellen Unterhaltung mit dem Modell.

Bei Abfragen mit einer einzigen Antwort ist dies eine einzelne Instanz. Bei Abfragen mit mehreren Antworten ist dies ein wiederkehrendes Feld, das den Unterhaltungsverlauf und die letzte Anfrage enthält.

tools[]

object (Tool)

Optional. Eine Liste von Tools, die das Modell zum Generieren der nächsten Antwort verwenden kann.

Ein Tool ist ein Code-Snippet, das dem System die Interaktion mit externen Systemen ermöglicht, um eine Aktion oder eine Reihe von Aktionen auszuführen, ohne dass das Modell es kennt und nicht. Das einzige unterstützte Tool ist derzeit Function.

toolConfig

object (ToolConfig)

Optional. Toolkonfiguration für jeden in der Anfrage angegebenen Tool.

safetySettings[]

object (SafetySetting)

Optional. Eine Liste eindeutiger SafetySetting-Instanzen zum Blockieren unsicherer Inhalte.

Diese Änderung wird für GenerateContentRequest.contents und GenerateContentResponse.candidates erzwungen. Es sollte nicht mehr als eine Einstellung für jeden SafetyCategory-Typ vorhanden sein. Die API blockiert alle Inhalte und Antworten, die die in diesen Einstellungen festgelegten Grenzwerte nicht erreichen. Durch diese Liste werden die Standardeinstellungen für jeden SafetyCategory überschrieben, der in den safetySettings angegeben ist. Wenn für eine bestimmte SafetyCategory in der Liste keine SafetySetting vorhanden ist, verwendet die API die standardmäßige Sicherheitseinstellung für diese Kategorie. Die Schadenskategorien HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT und HARM_CATEGORY_HARASSMENT werden unterstützt.

systemInstruction

object (Content)

Optional. Systemanweisung vom Entwickler festgelegt. Derzeit nur Text.

generationConfig

object (GenerationConfig)

Optional. Konfigurationsoptionen für Modellgenerierung und -ausgaben.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von GenerateContentResponse.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

Weitere Informationen finden Sie in der Authentifizierungsübersicht.