Method: models.batchEmbedText

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

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
model

string

Obbligatorio. Il nome dell'oggetto Model da utilizzare per generare l'incorporamento. Esempi: model/embedding-gecko-001

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "texts": [
    string
  ],
  "requests": [
    {
      object (EmbedTextRequest)
    }
  ]
}
Campi
texts[]

string

Campo facoltativo. I testi di input in formato libero che il modello trasformerà in un incorporamento. Il limite attuale è di 100 testi, oltre i quali verrà generato un errore.

requests[]

object (EmbedTextRequest)

Campo facoltativo. Incorporare le richieste per il batch. È possibile impostare solo uno dei seguenti valori: texts o requests.

Corpo della risposta

La risposta a una richiesta EmbedTextRequest.

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

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

object (Embedding)

Solo output. Gli incorporamenti generati dal testo di input.

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.

EmbedTextRequest

Richiedi di ottenere un incorporamento del testo dal modello.

Rappresentazione JSON
{
  "model": string,
  "text": string
}
Campi
model

string

Obbligatorio. Il nome del modello da utilizzare con il formato model=models/{model}.

text

string

Campo facoltativo. Il testo di input in formato libero che il modello trasformerà in un incorporamento.