Method: models.embedContent

Generiert eine Einbettung aus dem Modell anhand einer Eingabe-Content.

HTTP-Anfrage

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:embedContent

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
model

string

Erforderlich. Der Ressourcenname des Modells. Sie dient als ID für das zu verwendende Modell.

Dieser Name sollte mit einem Modellnamen übereinstimmen, der von der Methode models.list zurückgegeben wird.

Format: models/{model}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
Felder
content

object (Content)

Erforderlich. Der einzubettende Inhalt. Nur die parts.text-Felder werden gezählt.
taskType

enum (TaskType)

Optional. Optionaler Aufgabentyp, für den die Einbettungen verwendet werden. Kann nur für models/embedding-001 festgelegt werden.
title

string

Optional. Ein optionaler Titel für den Text. Gilt nur, wenn der TaskType RETRIEVAL_DOCUMENT ist.

Hinweis: Wenn Sie eine title für RETRIEVAL_DOCUMENT angeben, ist die Qualität der Einbettungen beim Abrufen besser.
outputDimensionality

integer

Optional. Optionale reduzierte Abmessungen für die Ausgabeeinbettung. Wenn festgelegt, werden übermäßig viele Werte in der Ausgabeeinbettung am Ende abgeschnitten. Wird seit 2024 von neueren Modellen unterstützt. Beim älteren Modell (models/embedding-001) kann dieser Wert nicht angegeben werden.

Antworttext

Die Antwort auf ein EmbedContentRequest.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "embedding": {
    object (ContentEmbedding)
  }
}
Felder
embedding

object (ContentEmbedding)

Nur Ausgabe. Die aus dem Eingabeinhalt generierte Einbettung.

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.