Method: models.batchEmbedContents

Génère plusieurs représentations vectorielles continues à partir du texte d'entrée fourni par le modèle dans un appel synchrone.

Requête HTTP

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

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 
{
  "requests": [
    {
      object (EmbedContentRequest)
    }
  ]
}
Champs
requests[]

object (EmbedContentRequest)

Obligatoire. Requêtes d'intégration pour le lot. Le modèle de chacune de ces requêtes doit correspondre au modèle spécifié dans BatchEmbedContentsRequest.model.

Corps de la réponse

Réponse à un événement BatchEmbedContentsRequest.

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

Représentation JSON 
{
  "embeddings": [
    {
      object (ContentEmbedding)
    }
  ]
}
Champs
embeddings[]

object (ContentEmbedding)

Uniquement en sortie. Représentations vectorielles continues de chaque requête, dans le même ordre que celui indiqué dans la requête par lot.

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.

EmbedContentRequest

Requête contenant le Content pour le modèle à intégrer.

Représentation JSON 
{
  "model": string,
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
Champs
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}
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.