文本向量化

POST

https://api.tokencube.net/v2/llm/embeddings

文本向量化 API，把文本（或图片、音频）转换成机器能理解的数字向量，适用于语义搜索、文本分类、AI上下文理解等场景。

当前展示通用接口文档，各模型支持的参数存在差异。请在顶部切换模型，或直接点击下方模型标签，查看专属文档。

支持模型:

请求参数

请求头

参数名称	描述
Authorizationstring	鉴权令牌，格式为 Bearer ${AIGATEWAY_TOKEN}
Content-Typestring	可选值：application/json application/json

Body参数

参数名称	描述
modelstring	默认值：Per AI gateway configuration 模型名称
inputstring	要生成嵌入的文本或文本列表

请求示例

curl -v 'https://${base_url}/v2/llm/embeddings' \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [
      "The food was delicious and the waiter",
      "what is your name"
    ]
  }'

响应参数

Body参数

参数名称	描述
objectstring	可选值：list 响应的对象类型，list表明是向量化结果列表
dataarray	嵌入向量结果列表，每个元素对应输入的一条文本
objectstring	可选值：embedding 该元素的对象类型，embedding表明是嵌入向量
embeddingarray	嵌入向量，浮点数数组
indexinteger	该嵌入在data数组中的索引位置
modelstring	生成嵌入所使用的模型名称
usageobject	此次请求所使用的token数量统计信息
prompt_tokensinteger	请求中使用token数，即输入内容占用token数
total_tokensinteger	请求总共使用token数

响应示例

{
  "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
  }
}

状态码

描述（message）	HTTP状态码
请求成功	200
访问被拒绝，拒绝原因见响应主体，可能原因为Authorization错误等	401
访问被拒绝，原因见响应主体（如格式错误、参数缺失等）	403
服务器内部错误，原因见响应主体	500

请求参数

请求示例

响应参数

响应示例

状态码

目录