Tạo một bản nhúng từ mô hình dựa vào Content
đầu vào.
Yêu cầu HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:embedContent
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 |
---|
{ "content": { object ( |
Trườ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ũ ( |
Nội dung phản hồi
Phản hồi cho một EmbedContentRequest
.
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 |
---|
{
"embedding": {
object ( |
Trường | |
---|---|
embedding |
Chỉ có đầu ra. Việc nhúng được tạo từ nội dung đầu vào. |
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.