Method: models.streamGenerateContent

Generiert eine gestreamte Antwort aus dem Modell mit einer Eingabe-GenerateContentRequest.

HTTP-Anfrage

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:streamGenerateContent

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)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "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 in mehreren Schritten ist dies ein wiederkehrendes Feld, das den Unterhaltungsverlauf und die letzte Anfrage enthält.
safetySettings[]

object (SafetySetting)

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

Dies wird für GenerateContentRequest.contents und GenerateContentResponse.candidates erzwungen. Für jeden SafetyCategory-Typ darf es nur eine Einstellung geben. Die API blockiert alle Inhalte und Antworten, die die in diesen Einstellungen festgelegten Grenzwerte nicht erreichen. Diese Liste überschreibt die Standardeinstellungen für jeden SafetyCategory, der in den SafetySettings angegeben ist. Wenn für eine bestimmte SafetyCategory in der Liste kein SafetySetting vorhanden ist, verwendet die API die standardmäßige Sicherheitseinstellung für diese Kategorie. Schadenskategorien HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT und HARM_CATEGORY_HARASSMENT werden unterstützt.
generationConfig

object (GenerationConfig)

Optional. Konfigurationsoptionen für Modellgenerierung und -ausgaben.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext einen Stream von GenerateContentResponse-Instanzen.

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.