Method: models.batchEmbedContents

Generuje wiele reprezentacji właściwościowych z modelu danego tekstu wejściowego w wywołaniu synchronicznym.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
model

string

Wymagane. Nazwa zasobu modelu. Służy jako identyfikator używanego modelu.

Ta nazwa powinna być zgodna z nazwą modelu zwróconej przez metodę models.list.

Format: models/{model}

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requests": [
    {
      object (EmbedContentRequest)
    }
  ]
}
Pola
requests[]

object (EmbedContentRequest)

Wymagane. Żądania umieszczenia na potrzeby wsadu. Model w każdym z tych żądań musi odpowiadać modelowi określonemu BatchEmbedContentsRequest.model.

Treść odpowiedzi

Odpowiedź na: BatchEmbedContentsRequest.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "embeddings": [
    {
      object (ContentEmbedding)
    }
  ]
}
Pola
embeddings[]

object (ContentEmbedding)

Tylko dane wyjściowe. Wektory dystrybucyjne dla każdego żądania w tej samej kolejności, w jakiej zostały podane w żądaniu zbiorczym.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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

Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania.

EmbedContentRequest

Żądanie zawierające Content umożliwiające umieszczenie modelu.

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

string

Wymagane. Nazwa zasobu modelu. Służy jako identyfikator używanego modelu.

Ta nazwa powinna być zgodna z nazwą modelu zwróconej przez metodę models.list.

Format: models/{model}
content

object (Content)

Wymagane. Treść do umieszczenia. Zliczane będą tylko pola parts.text.
taskType

enum (TaskType)

Opcjonalnie. Opcjonalny typ zadania, do którego będą używane wektory dystrybucyjne. Można ją ustawić tylko dla: models/embedding-001.
title

string

Opcjonalnie. Opcjonalny tytuł tekstu. Ma zastosowanie tylko wtedy, gdy TaskType ma wartość RETRIEVAL_DOCUMENT.

Uwaga: określenie właściwości title dla elementu RETRIEVAL_DOCUMENT umożliwia pobieranie blokad o lepszej jakości.
outputDimensionality

integer

Opcjonalnie. Opcjonalny zmniejszony rozmiar umieszczania danych wyjściowych. Jeśli jest ustawiony, nadmiarowe wartości we wektorze dystrybucyjnym są obcinane na końcu. Obsługiwane przez nowsze modele od 2024 roku, a wcześniejszy model (models/embedding-001) nie może określić tej wartości.