API 參考

向量嵌入

目前沒有可用模型

目前模型目錄裡沒有模型支援這個介面，本頁僅供參考。

POST/v1/embeddings

OpenAI 格式的向量嵌入——text-embedding-3、jina-embeddings、voyage 及各廠商等價模型。按輸入 token 計費。

#請求參數

modelstring必填
嵌入模型 ID，如 text-embedding-3-small。
inputstring | array必填
單個字串或陣列——回應會依同樣順序回傳向量。
dimensionsinteger選填
在支援 Matryoshka（俄羅斯娃娃）維度的模型上截斷向量。
encoding_formatstring選填
"float"（預設）或 "base64"（負載更精簡）。

#相關錯誤碼

400 invalid_request_error請求主體格式錯誤，或該模型不支援某個參數。
401Bearer 權杖無效或缺失。這條路徑不帶 error.code，請依狀態碼判斷。
402 insufficient_user_quota錢包餘額不足以覆蓋預扣估算。
429金鑰級限流。回應主體為空，按 Retry-After 等待。若 429 帶有 insufficient_user_quota，那是每日消費上限，不是限流。
503 model_not_found模型名稱不存在，或目前沒有健康的通道可以提供服務。

完整錯誤碼表 →

#請求範例

curl https://www.aisplice.store/v1/embeddings \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["hello world", "another sentence"]
  }'

#回應

response.json

{
  "object": "list",
  "model": "text-embedding-3-small",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, …]},
    {"object": "embedding", "index": 1, "embedding": [0.0154,  0.0007, …]}
  ],
  "usage": {"prompt_tokens": 8, "total_tokens": 8}
}

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。