ShareAI Platform Docs

建立文字嵌入

用 ShareAI 生成文字嵌入,用於語義搜索、檢索同相似性,支持嘅輸入格式同模型要求。

以Markdown檢視
喺呢頁面
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"
}'

請求字段#

字段價值
model一個啟用嘅嵌入模型 ID。
input一個非空字符串或者最多 128 個非空字符串嘅數組。
encoding_formatfloatbase64.
dimensions可選整數,範圍由 1 到 65536;所選模型必須支持呢個範圍。

閱讀向量#

睇下 data 數組,並使用每個結果嘅 index 嚟匹配佢嘅嵌入同輸入。喺嵌入你嘅文檔同搜索查詢時,保持相同嘅模型同維度。結果仲包括供應商報告嘅 usage.

喺限制內批量處理#

合併輸入文本限制喺 256 KiB。回應係同步嘅,限制喺 2 MiB,所以大向量或者批量可能會超過回應限制。減少批量大小或者使用支持嘅較細維度。唔接受 Token-ID 數組。

認證同可用性#

一個批准嘅 OAuth 訪問令牌可以取代 API 密鑰。賬戶資助嘅請求需要 surcharge 同一個接受嘅計劃。模型同供應商嘅限制仍然適用。如果模型未啟用嵌入功能,請揀一個可用嘅嵌入模型;更改憑證唔可以啟用模型。

使用情況#

嵌入會消耗輸入 Token。喺運行大批量之前檢查模型價格,並使用 控制台使用情況 嚟檢視活動。喺重試之前處理驗證、授權同可用性錯誤。

最後更新日期:2026年9月15日

ShareAI平台文檔
所有文檔

按標題或者內容搜尋。

問下關於呢頁嘅問題

選擇一個助手嚟探索呢頁。你亦可以複製呢頁,然後貼喺你嘅對話入面。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI