建立文字嵌入
用 ShareAI 生成文字嵌入,用於語義搜索、檢索同相似性,支持嘅輸入格式同模型要求。
喺呢頁面
POST
https://api.shareai.now/api/v1/embeddings將一個或多個文本轉換成嵌入向量。
- 基礎 URL
https://api.shareai.now- 認證
- Bearer API 密鑰或者已批准嘅 OAuth 訪問權杖
揀一個喺 ShareAI 啟用並由你嘅憑證允許嘅嵌入模型。聊天模型唔可以代替嵌入模型。模型嘅可用性同支持嘅選項取決於配置嘅供應商。
發送請求#
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());
請求字段#
| 字段 | 價值 |
|---|---|
model | 一個啟用嘅嵌入模型 ID。 |
input | 一個非空字符串或者最多 128 個非空字符串嘅數組。 |
encoding_format | float 或 base64. |
dimensions | 可選整數,範圍由 1 到 65536;所選模型必須支持呢個範圍。 |
閱讀向量#
睇下 data 數組,並使用每個結果嘅 index 嚟匹配佢嘅嵌入同輸入。喺嵌入你嘅文檔同搜索查詢時,保持相同嘅模型同維度。結果仲包括供應商報告嘅 usage.
喺限制內批量處理#
合併輸入文本限制喺 256 KiB。回應係同步嘅,限制喺 2 MiB,所以大向量或者批量可能會超過回應限制。減少批量大小或者使用支持嘅較細維度。唔接受 Token-ID 數組。
認證同可用性#
一個批准嘅 OAuth 訪問令牌可以取代 API 密鑰。賬戶資助嘅請求需要 surcharge 同一個接受嘅計劃。模型同供應商嘅限制仍然適用。如果模型未啟用嵌入功能,請揀一個可用嘅嵌入模型;更改憑證唔可以啟用模型。
使用情況#
嵌入會消耗輸入 Token。喺運行大批量之前檢查模型價格,並使用 控制台使用情況 嚟檢視活動。喺重試之前處理驗證、授權同可用性錯誤。
最後更新日期:2026年9月15日