跳至主要内容

Embeddings

POST /v1/embeddings​

將文字轉成向量表示。與 OpenAI Embeddings API 格式相容。

請求​

POST /v1/embeddings
Authorization: Bearer sk-your-api-key
Content-Type: application/json
{
  "model": "openai/text-embedding-3-small",
  "input": ["向量搜尋的原理", "如何評估 Embedding 品質"],
  "encoding_format": "float"
}

請求欄位​

欄位類型必填說明
modelstring✓Embedding 模型 ID
inputstring / string[]✓要轉換的文字，可傳單一字串或陣列
encoding_formatstringfloat（預設）或 base64

回應​

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0174, ..., 0.0041]
    },
    {
      "object": "embedding",
      "index": 1,
      "embedding": [0.0105, -0.0091, ..., 0.0033]
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 15,
    "total_tokens": 15
  },
  "vecstruct": {
    "audit_id": "019cdad6340575609cda639e439c1015",
    "credits_consumed": 0.01,
    "balance_consumed_usd": 0.000003
  }
}

vecstruct 回應欄位：

欄位類型說明
audit_idstring此次請求的 Audit Log ID
credits_consumednumber消耗的 Credits
balance_consumed_usdnumber消耗的 USD 餘額

可用的 Embedding 模型​

模型 ID維度說明
openai/text-embedding-3-small1536性價比高，適合大量文字
openai/text-embedding-3-large3072較高精度
baai/bge-m31024多語言，中英文效果佳

完整模型列表請參考 GET /v1/models?type=embedding。

錯誤碼​

錯誤碼HTTP說明
1511404模型不存在
1512400模型未啟用
1508402USD 餘額不足
1007429超過速率限制
2400402預算上限已達（啟用 Budget Cap 且 action 為 block 時觸發）