嵌入向量

建立嵌入向量

將文字(或部分模型支援的多模態內容)轉換為向量嵌入。請求與回應格式跟 OpenAI 的 embeddings API 一致,可直接搭配 client.embeddings.create() 使用。input 可以是單一字串或字串陣列。

POST/api/v1/embeddings

驗證

Authorization必填

string · header

在 Authorization 標頭以 Bearer token 傳入 API 金鑰。

Body

model必填

string

要使用的嵌入向量模型,供應商前綴格式,例如 "openai/text-embedding-3-small"。

minLength: 1

Example: "openai/text-embedding-3-small"

input必填

string | string[]

要嵌入的文字。可以是單一字串,或字串陣列(一次請求算多筆)。部分模型另外接受結構化的多模態內容項目,原樣轉發給上游,實際支援與否依模型而定。

Example: "The quick brown fox"

encoding_format

string

編碼格式,原樣轉發給上游,本端不做驗證或限制;實際支援的值依上游而定。

Example: "float"

dimensions

integer

輸出向量的維度數,原樣轉發給上游,本端不做驗證;僅部分模型支援自訂維度,不支援時由上游決定行為(通常忽略或報錯)。

provider

object

供應商路由偏好(order、only、ignore、allow_fallbacks、sort 等)。只有部分模型路由會轉發並套用此欄位;不支援的路由會靜默忽略,不會送出。

POST /api/v1/embeddings

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/embeddings \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "The quick brown fox"
  }'

回應範例

成功。回傳 OpenAI 相容格式,data[] 依 input 順序對應每筆嵌入結果;usage.cost 是本次請求實際計費金額。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0023064255,
        -0.009327292,
        0.015797347
      ]
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 5,
    "total_tokens": 5,
    "cost": 1e-7
  }
}