Method: models.embedContent

Génère une représentation vectorielle continue à partir du modèle en fonction d'une Content d'entrée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
model

string

Obligatoire. Nom de ressource du modèle. Il servira d'ID au modèle à utiliser.

Ce nom doit correspondre à un nom de modèle renvoyé par la méthode models.list.

Format : models/{model}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
Champs
content

object (Content)

Obligatoire. Contenu à intégrer. Seuls les champs parts.text seront comptabilisés.
taskType

enum (TaskType)

Facultatif. Type de tâche facultatif pour lequel les représentations vectorielles continues seront utilisées. Ne peut être défini que pour models/embedding-001.
title

string

Facultatif. Titre facultatif pour le texte. S'applique uniquement lorsque TaskType est défini sur RETRIEVAL_DOCUMENT.

Remarque: Spécifier un title pour RETRIEVAL_DOCUMENT améliore la qualité des représentations vectorielles continues pour la récupération.
outputDimensionality

integer

Facultatif. Dimension réduite facultative pour la représentation vectorielle continue de la sortie. Si cette règle est définie, les valeurs excessives dans la représentation vectorielle continue de la sortie sont tronquées à la fin. Compatible avec les modèles plus récents depuis 2024, et l'ancien modèle (models/embedding-001) ne peut pas spécifier cette valeur.

Corps de la réponse

Réponse à un événement EmbedContentRequest.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "embedding": {
    object (ContentEmbedding)
  }
}
Champs
embedding

object (ContentEmbedding)

Uniquement en sortie. Représentation vectorielle continue générée à partir du contenu d'entrée.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez la page Présentation de l'authentification.