- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- EmbedContentRequest
Genera più incorporamenti dal testo di input del modello specificato in una chiamata sincrona.
Richiesta HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:batchEmbedContents
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
model |
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 Formato: |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"requests": [
{
object ( |
Campi | |
---|---|
requests[] |
Obbligatoria. Incorpora le richieste per il batch. Il modello in ciascuna di queste richieste deve corrispondere al modello specificato |
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 ( |
Campi | |
---|---|
embeddings[] |
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 ( |
Campi | |
---|---|
model |
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 Formato: |
content |
Obbligatoria. I contenuti da incorporare. Verranno conteggiati solo i campi |
taskType |
Campo facoltativo. Tipo di attività facoltativa per cui verranno utilizzati gli incorporamenti. Può essere impostato solo per |
title |
Campo facoltativo. Un titolo facoltativo per il testo. Applicabile solo quando TaskType è Nota: l'indicazione di un |
outputDimensionality |
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 ( |