Method: models.batchEmbedContents

Genera più incorporamenti dal testo di input del modello specificato in una chiamata sincrona.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
model

string

Obbligatoria. Il nome della risorsa del modello. che funge da ID per il modello.

Questo nome deve corrispondere a un nome di modello restituito dal metodo models.list.

Formato: models/{model}

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requests": [
    {
      object (EmbedContentRequest)
    }
  ]
}
Campi
requests[]

object (EmbedContentRequest)

Obbligatoria. Incorpora le richieste per il batch. Il modello in ciascuna di queste richieste deve corrispondere al modello specificato BatchEmbedContentsRequest.model.

Corpo della risposta

La risposta a un BatchEmbedContentsRequest.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "embeddings": [
    {
      object (ContentEmbedding)
    }
  ]
}
Campi
embeddings[]

object (ContentEmbedding)

Solo output. Gli incorporamenti per ogni richiesta, nello stesso ordine fornito nella richiesta batch.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti 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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

EmbedContentRequest

Richiesta contenente il Content per l'incorporamento del modello.

Rappresentazione JSON 
{
  "model": string,
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
Campi
model

string

Obbligatoria. Il nome della risorsa del modello. che funge da ID per il modello.

Questo nome deve corrispondere a un nome di modello restituito dal metodo models.list.

Formato: models/{model}
content

object (Content)

Obbligatoria. I contenuti da incorporare. Verranno conteggiati solo i campi parts.text.
taskType

enum (TaskType)

Campo facoltativo. Tipo di attività facoltativa per cui verranno utilizzati gli incorporamenti. Può essere impostato solo per models/embedding-001.
title

string

Campo facoltativo. Un titolo facoltativo per il testo. Applicabile solo quando TaskType è RETRIEVAL_DOCUMENT.

Nota: l'indicazione di un title per RETRIEVAL_DOCUMENT fornisce incorporamenti di qualità migliore per il recupero.
outputDimensionality

integer

Campo facoltativo. Dimensione ridotta facoltativa per l'incorporamento dell'output. Se impostato, i valori eccessivi nell'incorporamento dell'output vengono troncati dalla fine. Questo valore è supportato dai modelli più recenti dal 2024 e il modello precedente (models/embedding-001) non può specificare questo valore.