Method: models.batchEmbedContents

Tạo nhiều nhúng từ mô hình có văn bản đầu vào đã cho trong một lệnh gọi đồng bộ.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
model

string

Bắt buộc. Tên tài nguyên của mô hình. Mã này đóng vai trò là mã nhận dạng cho Mô hình sử dụng.

Tên này phải khớp với tên mô hình được phương thức models.list trả về.

Định dạng models/{model}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "requests": [
    {
      object (EmbedContentRequest)
    }
  ]
}
Trường
requests[]

object (EmbedContentRequest)

Bắt buộc. Nhúng các yêu cầu cho lô đó. Mô hình trong mỗi yêu cầu này phải phù hợp với mô hình được chỉ định BatchEmbedContentsRequest.model.

Nội dung phản hồi

Phản hồi cho BatchEmbedContentsRequest.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "embeddings": [
    {
      object (ContentEmbedding)
    }
  ]
}
Trường
embeddings[]

object (ContentEmbedding)

Chỉ có đầu ra. Các hoạt động nhúng cho từng yêu cầu theo cùng thứ tự như được cung cấp trong yêu cầu hàng loạt.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • 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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về hoạt động xác thực.

EmbedContentRequest

Yêu cầu chứa Content để mô hình nhúng.

Biểu diễn dưới dạng JSON 
{
  "model": string,
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
Trường
model

string

Bắt buộc. Tên tài nguyên của mô hình. Mã này đóng vai trò là mã nhận dạng cho Mô hình sử dụng.

Tên này phải khớp với tên mô hình được phương thức models.list trả về.

Định dạng models/{model}
content

object (Content)

Bắt buộc. Nội dung cần nhúng. Hệ thống sẽ chỉ tính các trường parts.text.
taskType

enum (TaskType)

Không bắt buộc. Loại tác vụ không bắt buộc sẽ sử dụng các tính năng nhúng. Chỉ có thể đặt cho models/embedding-001.
title

string

Không bắt buộc. Tiêu đề không bắt buộc cho văn bản. Chỉ áp dụng khi TaskType là RETRIEVAL_DOCUMENT.

Lưu ý: Việc chỉ định title cho RETRIEVAL_DOCUMENT sẽ cung cấp các hoạt động nhúng có chất lượng tốt hơn để truy xuất.
outputDimensionality

integer

Không bắt buộc. Kích thước giảm (không bắt buộc) để nhúng đầu ra. Nếu bạn đặt chính sách này, thì các giá trị quá mức trong tệp nhúng đầu ra sẽ bị cắt bớt từ cuối. Được các mô hình mới hỗ trợ kể từ năm 2024 và mô hình cũ (models/embedding-001) không thể chỉ định giá trị này.