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.
Trên trang này
https://api.shareai.now/api/v1/embeddingsChuyể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"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_EMBEDDING_MODEL', 'input': ['How do I connect a device?', 'Where can I read my usage?'], 'encoding_format': 'float'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/embeddings', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/embeddings";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_EMBEDDING_MODEL",
"input": [
"How do I connect a device?",
"Where can I read my usage?"
],
"encoding_format": "float"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
Các trường yêu cầu#
| Trường | Giá trị |
|---|---|
model | Một ID mô hình nhúng đã được kích hoạt. |
input | Mộ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_format | float hoặc base64. |
dimensions | Số 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