- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- EmbedContentRequest
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/v1/{model=models/*}:batchEmbedContents
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
model |
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 Định dạng |
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 ( |
Trường | |
---|---|
requests[] |
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 |
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 ( |
Trường | |
---|---|
embeddings[] |
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 ( |
Trường | |
---|---|
model |
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 Định dạng |
content |
Bắt buộc. Nội dung cần nhúng. Hệ thống sẽ chỉ tính các trường |
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 |
title |
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à Lưu ý: Việc chỉ định |
outputDimensionality |
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ũ ( |