/v1/embeddings

POST https://ai-api.mandao.com/v1/embeddings

文本向量化接口，OpenAI Embeddings API 兼容格式。返回输入文本的向量表示。

请求参数

Header 参数

参数名	类型	必需	说明
Authorization	string	是	Bearer Token 认证
Content-Type	string	是	`application/json`

Body 参数 (application/json)

参数名	类型	必需	默认值	说明
model	string	是	-	模型 ID，如 `text-embedding-3-small`、`text-embedding-3-large`
input	string 或 array[string]	是	-	待向量化的文本，支持字符串或字符串数组
encoding_format	string	否	float	编码格式：`float` 或 `base64`
dimensions	integer	否	-	向量维度。仅 `text-embedding-3-*` 模型支持
user	string	否	-	用户标识

请求示例

curl --location 'https://ai-api.mandao.com/v1/embeddings' \
--header 'Authorization: Bearer <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "text-embedding-3-large",
    "input": "The food was delicious and the service was excellent."
}'

返回响应

200 成功

{
    "object": "list",
    "data": [
        {
            "object": "embedding",
            "index": 0,
            "embedding": [0.0023064255, -0.009327292, ...]
        }
    ],
    "model": "text-embedding-3-large",
    "usage": {
        "prompt_tokens": 12,
        "total_tokens": 12
    }
}

错误响应

{
    "error": {
        "message": "错误描述",
        "type": "invalid_request_error",
        "code": "invalid_model"
    }
}

注意事项

单次请求的文本长度不应超过模型的上下文限制。
input 支持数组输入，可一次向量化多条文本。
dimensions 参数仅对 text-embedding-3-* 系列模型有效。