- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- EmbedContentRequest
Gera vários embeddings do modelo com base no texto de entrada em uma chamada síncrona.
Solicitação HTTP
POST https://generativelanguage.googleapis.com/v1/{model=models/*}:batchEmbedContents
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
model |
Obrigatório. O nome do recurso do modelo. Isso serve como um ID a ser usado pelo modelo. Esse nome precisa corresponder ao nome de um modelo retornado pelo método Formato: |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{
"requests": [
{
object ( |
Campos | |
---|---|
requests[] |
Obrigatório. Incorporar solicitações para o lote. O modelo em cada uma dessas solicitações precisa corresponder ao modelo especificado |
Corpo da resposta
A resposta a uma BatchEmbedContentsRequest
.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"embeddings": [
{
object ( |
Campos | |
---|---|
embeddings[] |
Apenas saída. Os embeddings de cada solicitação, na mesma ordem fornecida na solicitação em lote. |
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.
EmbedContentRequest
Solicitação contendo o Content
para o modelo incorporar.
Representação JSON |
---|
{ "model": string, "content": { object ( |
Campos | |
---|---|
model |
Obrigatório. O nome do recurso do modelo. Isso serve como um ID a ser usado pelo modelo. Esse nome precisa corresponder ao nome de um modelo retornado pelo método Formato: |
content |
Obrigatório. O conteúdo a ser incorporado. Somente os campos |
taskType |
Opcional. Tipo de tarefa opcional em que os embeddings serão usados. Só pode ser definido para |
title |
Opcional. Um título opcional para o texto. Aplicável apenas quando o TaskType é Observação: especificar um |
outputDimensionality |
Opcional. Dimensão reduzida opcional para o embedding de saída. Se definido, os valores em excesso no embedding de saída serão truncados no final. Com suporte nos modelos mais recentes desde 2024, e o modelo anterior ( |