Method: models.batchEmbedText

Gera vários embeddings do texto de entrada fornecido do modelo em uma chamada síncrona.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
model

string

Obrigatório. O nome do Model a ser usado para gerar o embedding. Exemplos: models/embedding-gecko-001

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "texts": [
    string
  ],
  "requests": [
    {
      object (EmbedTextRequest)
    }
  ]
}
Campos
texts[]

string

Opcional. Os textos de entrada de formato livre que o modelo transformará em um embedding. O limite atual é de 100 textos, em que um erro será gerado.

requests[]

object (EmbedTextRequest)

Opcional. Incorporar solicitações para o lote. Só é possível definir texts ou requests.

Corpo da resposta

A resposta para uma EmbedTextRequest.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "embeddings": [
    {
      object (Embedding)
    }
  ]
}
Campos
embeddings[]

object (Embedding)

Apenas saída. Os embeddings gerados a partir do texto de entrada.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • 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

Para saber mais, consulte a Visão geral da autenticação.

EmbedTextRequest

Solicitação para receber um embedding de texto do modelo.

Representação JSON
{
  "model": string,
  "text": string
}
Campos
model

string

Obrigatório. O nome do modelo a ser usado com o formato model=models/{model}.

text

string

Opcional. O texto de entrada de formato livre que o modelo transformará em um embedding.