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"
}

請求欄位

欄位	類型	必填	說明
model	string	✓	Embedding 模型 ID
input	string / string[]	✓	要轉換的文字，可傳單一字串或陣列
encoding_format	string		float（預設）或 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
  }
}

可用的 Embedding 模型

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

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