原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看快速开始。

POST 文本向量化

POST /v1/embeddings 文本向量化
所属分组：文本向量化

BASE URLYOUR_PROJECT_BASE_URL（从项目 API Key 页复制，保留项目路径与版本路径）

认证方式Authorization: Bearer 项目 API Key

端点列表

← 上一页

POST 聊天补全

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥

POST/v1/embeddings文本向量化

将文本转换为向量表示

请求参数

参数	位置 / 类型	说明
`HTTP-Referer`	header / string	用于在胜算云Router中排名的应用网站URL
`X-Title`	header / string	用于在胜算云Router中排名的应用名称

请求体

application/json

字段	类型	说明
`model`必填	string	请求使用的模型 ID。支持的模型ID: - openai/text-embedding-ada-002 - openai/text-embedding-3-small - openai/text-embedding-3-large - baai/bge-m3 - bytedance/doubao-embedding-large - bytedance/doubao-embedding
`input`必填	union	输入内容展开结构输入内容 `union` oneOf · 1 `string` oneOf · 2 `array` 数组元素 `string`
`encoding_format`	string
`dimensions`	integer
`seed`	number
`temperature`	number
`frequency_penalty`	number
`presence_penalty`	number

{
  "model": "ali/text-embedding-v3",
  "input": [
    "如何使用torchserve部署模型",
    "怎么使用训练机器学习模型"
  ]
}

请求示例

参考地址：YOUR_PROJECT_BASE_URL。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'YOUR_PROJECT_BASE_URL/v1/embeddings' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "ali/text-embedding-v3",
  "input": [
    "如何使用torchserve部署模型",
    "怎么使用训练机器学习模型"
  ]
}'

响应

200 成功响应（下方向量为缩短后的结构示意，非实际维度）

application/json

OpenAI%20Embedding%20%E5%93%8D%E5%BA%94

"{\n    \"id\": \"202504101500559418281XA86wFOO\",\n    \"provider\": \"Ali\",\n    \"model\": \"ali/text-embedding-v3\",\n    \"object\": \"list\",\n    \"created\": 1744268455,\n    \"data\": [\n        {\n            \"object\": \"embedding\",\n            \"index\": 0,\n            \"embedding\": [\n                -0.01420350931584835,\n                -0.009542533196508884,\n                -0.046993378549814224,\n                0.0012923178728669882,\n                -0.03646302595734596\n            ]\n        },\n        {\n            \"object\": \"embedding\",\n            \"index\": 1,\n            \"embedding\": [\n                -0.06518170237541199,\n                -0.04570785164833069,\n                -0.06909951567649841,\n                -0.02899952046573162,\n                -0.07002135366201401\n            ]\n        }\n    ],\n    \"usage\": {\n        \"prompt_tokens\": 13,\n        \"total_tokens\": 13\n    }\n}"

400 参数错误

application/json

string

{
  "error": {
    "message": "input is empty (request id: 20250410172315544779037X7p0lu5R)",
    "type": "ssy_api_error",
    "param": "",
    "code": "invalid_embedding_request"
  }
}