嵌入向量

创建嵌入向量

将文本(或部分模型支持的多模态内容)转换为向量嵌入。请求与响应格式跟 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
  }
}