API 目录

创建嵌入

POST
/v1/embeddings

创建嵌入向量

POST https://www.vortapapi.com/v1/embeddings

为输入内容生成嵌入向量。嵌入向量可用于语义搜索、聚类、推荐、相似度计算等机器学习或检索增强场景。

该接口兼容 OpenAI API 格式。

请求头

名称类型必填说明
Authorizationstring使用 Bearer Token 进行认证,格式为 Bearer sk-***
Content-Typestring固定为 application/json

请求体

字段类型必填说明
modelstring用于生成嵌入的模型名称,例如 text-embedding-ada-002
inputstring 或 array需要转换为嵌入向量的文本。可以是单个字符串,也可以是字符串数组

请求示例

curl https://www.vortapapi.com/v1/embeddings \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-ada-002",
    "input": "Vortap provides an OpenAI-compatible API gateway."
  }'

响应示例

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "embedding": [
        0.0023064255,
        -0.009327292,
        -0.0028842222
      ],
      "index": 0
    }
  ],
  "model": "text-embedding-ada-002",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}

响应字段

字段类型说明
objectstring返回对象类型,通常为 list
dataarray嵌入结果列表
data[].objectstring单条结果的对象类型,通常为 embedding
data[].embeddingarray输入文本对应的浮点数向量
data[].indexinteger该结果在输入列表中的位置
modelstring实际使用的嵌入模型
usage.prompt_tokensinteger输入消耗的 token 数
usage.total_tokensinteger本次请求消耗的总 token 数