Method: models.batchEmbedText

Genera varias incorporaciones a partir del texto de entrada del modelo en una llamada síncrona.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
model

string

Obligatorio. Es el nombre de la Model que se usará para generar la incorporación. Ejemplos: models/embedding-gecko-001

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "texts": [
    string
  ],
  "requests": [
    {
      object (EmbedTextRequest)
    }
  ]
}
Campos
texts[]

string

Opcional. Los textos de entrada de formato libre que el modelo convertirá en una incorporación. El límite actual es de 100 textos y se mostrará un error.

requests[]

object (EmbedTextRequest)

Opcional. Incorpora solicitudes para el lote. Solo se puede establecer una de texts o requests.

Cuerpo de la respuesta

Es la respuesta a una EmbedTextRequest.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "embeddings": [
    {
      object (Embedding)
    }
  ]
}
Campos
embeddings[]

object (Embedding)

Solo salida. Las incorporaciones generadas a partir del texto de entrada

Permisos de autorización

Se necesita uno de los siguientes alcances 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 obtener más información, consulta Descripción general de la autenticación.

EmbedTextRequest

Solicitud para obtener una incorporación de texto del modelo.

Representación JSON
{
  "model": string,
  "text": string
}
Campos
model

string

Obligatorio. El nombre del modelo que se usará con el formato model=models/{model}.

text

string

Opcional. Texto de entrada de formato libre que el modelo convertirá en una incorporación.