Method: models.batchEmbedContents

Создает несколько внедрений из модели с учетом входного текста в синхронном вызове.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
model

string

Необходимый. Имя ресурса модели. Это служит идентификатором для использования модели.

Это имя должно соответствовать имени модели, возвращаемому методом models.list .

Формат: models/{model}

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "requests": [
    {
      object (EmbedContentRequest)
    }
  ]
}
Поля
requests[]

object ( EmbedContentRequest )

Необходимый. Встраивание запросов на пакет. Модель в каждом из этих запросов должна соответствовать модели, указанной BatchEmbedContentsRequest.model .

Тело ответа

Ответ на BatchEmbedContentsRequest .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "embeddings": [
    {
      object (ContentEmbedding)
    }
  ]
}
Поля
embeddings[]

object ( ContentEmbedding )

Только вывод. Внедрения для каждого запроса в том же порядке, который указан в пакетном запросе.

Области авторизации

Требуется одна из следующих областей 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

Для получения дополнительной информации см. Обзор аутентификации .

ВстроитьСодержимоеЗапрос

Запрос, содержащий Content для встраиваемой модели.

JSON-представление
{
  "model": string,
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
Поля
model

string

Необходимый. Имя ресурса модели. Это служит идентификатором для использования модели.

Это имя должно соответствовать имени модели, возвращаемому методом models.list .

Формат: models/{model}

content

object ( Content )

Необходимый. Содержимое для встраивания. Будут учитываться только поля parts.text .

taskType

enum ( TaskType )

Необязательный. Необязательный тип задачи, для которого будут использоваться внедрения. Может быть установлено только для models/embedding-001 .

title

string

Необязательный. Необязательный заголовок текста. Применимо только в том случае, если TaskType имеет значение RETRIEVAL_DOCUMENT .

Примечание. Указание title для RETRIEVAL_DOCUMENT обеспечивает более качественное внедрение при поиске.

outputDimensionality

integer

Необязательный. Необязательный уменьшенный размер для встраивания вывода. Если установлено, лишние значения в выходном внедрении обрезаются с конца. Поддерживается более новыми моделями с 2024 года, а более ранняя модель ( models/embedding-001 ) не может указать это значение.