text-embedding-3-large
openai/text-embedding-3-large — OpenAI 第三代大尺寸文本向量化模型,最高 3072 维,支持通过 dimensions 参数降维。输入文本(字符串、字符串数组或 token 数组),返回对应向量,适用于语义搜索、聚类、推荐与分类。
同步任务:/v1/embeddings,直接返回结果。
BASE URL
https://router.shengsuanyun.com/api认证方式
Authorization: Bearer YOUR_API_KEY端点列表
POST/v1/embeddingsOpenAI 文本向量化-同步
OpenAI 第三代大尺寸文本向量化模型,最高 3072 维,支持通过 dimensions 参数降维。输入文本(字符串、字符串数组或 token 数组),返回对应向量,适用于语义搜索、聚类、推荐与分类。。同步接口:直接返回输入文本的向量表示,无需轮询。
请求体
application/json
| 字段 | 类型 | 说明 |
|---|---|---|
model必填 | string | 路由模型,本页固定为 openai/text-embedding-3-large |
input必填 | union | 要嵌入的输入文本。可以是字符串、字符串数组、token 数组或 token 数组的数组。输入不能为空;数组长度需符合上游接口限制。展开结构要嵌入的输入文本。可以是字符串、字符串数组、token 数组或 token 数组的数组。输入不能为空;数组长度需符合上游接口限制。
oneOf · 1
oneOf · 2
数组元素
oneOf · 3
数组元素
oneOf · 4
数组元素
数组元素
|
encoding_format | string | 返回向量的编码格式。 可选值:"float" · "base64" |
dimensions | integer | 返回向量的维度。仅 text-embedding-3 及之后的模型支持。 |
user | string | 代表最终用户的唯一标识,可用于监控和滥用检测。 |
{
"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"
}