ShareAI Platform Docs

Tạo nhúng văn bản

Tạo nhúng văn bản với ShareAI để tìm kiếm ngữ nghĩa, truy xuất và tương đồng, với các định dạng đầu vào được hỗ trợ và yêu cầu mô hình.

Xem dưới dạng Markdown
Trên trang này
POST https://api.shareai.now/api/v1/embeddings

Chuyển đổi một hoặc nhiều văn bản thành các vector nhúng.

URL cơ sở
https://api.shareai.now
Xác thực
Khóa API Bearer hoặc token truy cập OAuth đã được phê duyệt

Chọn một mô hình nhúng được kích hoạt trên ShareAI và được phép bởi thông tin xác thực của bạn. Các mô hình trò chuyện không thể thay thế cho các mô hình nhúng. Khả dụng của mô hình và các tùy chọn được hỗ trợ phụ thuộc vào nhà cung cấp đã cấu hình.

Gửi một yêu cầu#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/embeddings" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_EMBEDDING_MODEL",
  "input": [
    "How do I connect a device?",
    "Where can I read my usage?"
  ],
  "encoding_format": "float"
}'

Các trường yêu cầu#

TrườngGiá trị
modelMột ID mô hình nhúng đã được kích hoạt.
inputMột chuỗi không rỗng hoặc một mảng chứa tối đa 128 chuỗi không rỗng.
encoding_formatfloat hoặc base64.
dimensionsSố nguyên tùy chọn từ 1 đến 65536; mô hình được chọn phải hỗ trợ giá trị này.

Đọc các vector#

Đọc data mảng và sử dụng kết quả của từng phần tử index để khớp nhúng của nó với đầu vào. Giữ nguyên mô hình và kích thước khi nhúng tài liệu và truy vấn tìm kiếm của bạn. Kết quả cũng bao gồm thông tin được báo cáo bởi nhà cung cấp usage.

Xử lý theo lô trong giới hạn#

Văn bản đầu vào kết hợp bị giới hạn ở 256 KiB. Phản hồi là đồng bộ và bị giới hạn ở 2 MiB, vì vậy các vector hoặc lô lớn có thể vượt quá giới hạn phản hồi. Giảm kích thước lô hoặc sử dụng các kích thước nhỏ hơn được hỗ trợ. Không chấp nhận các mảng Token-ID.

Xác thực và khả dụng#

Một mã thông báo OAuth được phê duyệt có thể thay thế khóa API. Các yêu cầu được tài trợ bởi tài khoản yêu cầu surcharge và một gói đã được chấp nhận. Các hạn chế về mô hình và nhà cung cấp vẫn được áp dụng. Nếu mô hình không được kích hoạt cho nhúng, hãy chọn một mô hình nhúng khả dụng; thay đổi thông tin xác thực không thể kích hoạt một mô hình.

Sử dụng#

Nhúng tiêu thụ các token đầu vào. Kiểm tra giá mô hình trước khi chạy một lô lớn và sử dụng Bảng điều khiển Sử dụng để xem lại hoạt động. Xử lý lỗi xác thực, ủy quyền và khả dụng trước khi thử lại.

Cập nhật lần cuối Tháng 9 15, 2026

Tài liệu Nền tảng ShareAI
Tất cả tài liệu

Tìm kiếm theo tiêu đề hoặc nội dung.

Hỏi về trang này

Chọn một trợ lý để khám phá trang này. Bạn cũng có thể sao chép trang và dán vào cuộc trò chuyện của mình.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI