Skip to content

Embeddings 文本向量化

POST /api/v1/embeddings
Authorization: Bearer sk-xxx
Content-Type: application/json

兼容 OpenAI 的 Embeddings 接口,将文本转换为向量表示。

Request

字段类型必填说明
modelstring*模型 ID,如 text-embedding-3-small
inputstring or array*输入文本,可以是单个字符串或字符串数组
encoding_formatstring可选编码格式:float(默认)或 base64
dimensionsinteger可选输出向量的维度
userstring可选用户标识

请求示例:

json
{
  "model": "text-embedding-3-small",
  "input": "你好世界"
}

批量请求:

json
{
  "model": "text-embedding-3-small",
  "input": ["你好", "世界", "Hello World"]
}

Response

json
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, ...]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}
字段类型说明
objectstring固定为 list
dataarray嵌入向量列表
data[i].objectstring固定为 embedding
data[i].indexinteger对应输入的顺序
data[i].embeddingarray or string浮点数组或 base64 编码字符串
modelstring使用的模型 ID
usage.prompt_tokensinteger输入 token 数
usage.total_tokensinteger总 token 数

Python 示例

python
from openai import OpenAI

client = OpenAI(
    base_url="https://limapi.com/api/v1",
    api_key="sk-xxx",
)

result = client.embeddings.create(
    model="text-embedding-3-small",
    input=["你好", "世界"],
)

print(result.data[0].embedding[:5])

LimAPI — 大模型聚合网关