嵌入向量

建立嵌入向量

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

POST/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

不支援此欄位。整個物件會被忽略並在送往上游前移除,不能用來選擇上游或價格層級。

POST /v1/embeddings

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/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 是本次請求向客戶收取的美元金額。回應中的不透明 BazaarLink 請求 ID 與 x-request-id 相同；使用該 ID 呼叫 GET /v1/generation。統計資料可能延遲數秒；若收到 404，請短暫重試。非串流回應也會在 x-generation-id 提供同一 ID。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "id": "85e6f35c71a31f19-SJC",
  "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
  }
}