创建文本向量

重要

本接口适用模型:bge-large-zh:latest, gte-qwen2:7b,qwen3-embedding:8b

请求方式: POST

请求地址: /embeddings

请求参数:

• model: 必选 , 模型名, 对应接口 /v1/models 中的 id, 例如 "model": "bge-large-zh:latest"
• input: 必选 , 要嵌入的输入文本, 编码为字符串或标记数组. 要在单个请求中嵌入多个输入, 传递字符串数组或标记数组数组. 输入不得超过模型的最大输入token数（8192）, 不能为空字符串, 且任何数组的维度不得超过模型限制, bge-large-zh:latest 为 1024
• encoding_format: 可选, 返回嵌入的格式. 可以是float或base64, 默认为float

请求和响应示例

curl -X POST "https://uni-api.cstcloud.cn/v1/embeddings" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer {Token}" \
    -d '{
        "model": "bge-large-zh:latest",
        "input": "你好",
        "encoding_format": "float"
    }'

返回结果

{
    "object": "list",
    "model": "bge-large-zh-0",
    "data": [
        {
            "index": 0,
            "object": "embedding",
            "embedding": [
                -0.025075098499655724,
                -0.020222576335072517,
                ...,
                0.008755994960665703
            ]
        }
    ],
    "usage": {
        "prompt_tokens": 423,
        "total_tokens": 423
    }
}