统一模型接入与用量管理 立即注册
蓝天
原站参考文档

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

查看原文

text-embedding-3-large

openai/text-embedding-3-large — OpenAI 第三代大尺寸文本向量化模型,最高 3072 维,支持通过 dimensions 参数降维。输入文本(字符串、字符串数组或 token 数组),返回对应向量,适用于语义搜索、聚类、推荐与分类。
同步任务:/v1/embeddings,直接返回结果。

BASE URLhttps://router.shengsuanyun.com/api
认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页
OpenAI Embeddings 系列 · 接口汇总
下一页 →
Ali Rerank 系列 · 接口汇总

接口参考

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

蓝天 API 密钥
POST/v1/embeddingsOpenAI 文本向量化-同步

OpenAI 第三代大尺寸文本向量化模型,最高 3072 维,支持通过 dimensions 参数降维。输入文本(字符串、字符串数组或 token 数组),返回对应向量,适用于语义搜索、聚类、推荐与分类。。同步接口:直接返回输入文本的向量表示,无需轮询。

请求体

application/json
字段类型说明
model必填string路由模型,本页固定为 openai/text-embedding-3-large
input必填union要嵌入的输入文本。可以是字符串、字符串数组、token 数组或 token 数组的数组。输入不能为空;数组长度需符合上游接口限制。
展开结构

要嵌入的输入文本。可以是字符串、字符串数组、token 数组或 token 数组的数组。输入不能为空;数组长度需符合上游接口限制。

union

oneOf · 1

string

oneOf · 2

array

数组元素

string

oneOf · 3

array

数组元素

integer

oneOf · 4

array

数组元素

array

数组元素

integer

encoding_formatstring返回向量的编码格式。

可选值:"float" · "base64"

dimensionsinteger返回向量的维度。仅 text-embedding-3 及之后的模型支持。
userstring代表最终用户的唯一标识,可用于监控和滥用检测。
{
  "model": "openai/text-embedding-3-large",
  "input": "The food was delicious and the waiter..."
}

请求示例

参考地址:https://router.shengsuanyun.com/api。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/embeddings' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "openai/text-embedding-3-large",
  "input": "The food was delicious and the waiter..."
}'

响应

200 成功

application/json

未提供结构定义。

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "embedding": [
        0.0023064255,
        -0.009327292,
        -0.0028842222
      ],
      "index": 0
    }
  ],
  "model": "openai/text-embedding-3-large",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}
400 请求参数错误。

application/json

未提供结构定义。

{
  "code": "invalid_request_error",
  "message": "Invalid request parameters.",
  "request_id": "req_1234567890"
}
401 认证失败。

application/json

未提供结构定义。

{
  "code": "unauthorized",
  "message": "Invalid API key.",
  "request_id": "req_1234567890"
}
429 请求过于频繁。

application/json

未提供结构定义。

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded.",
  "request_id": "req_1234567890"
}
500 服务器内部错误。

application/json

未提供结构定义。

{
  "code": "internal_server_error",
  "message": "Internal server error.",
  "request_id": "req_1234567890"
}