文档中心

对象存储

请输入

向量

PutVectors

功能描述

往向量索引中批量插入向量。

请求消息样式

Endpoint 需使用 Bucket Endpoint。

POST /PutVectors HTTP/1.1​
Host: {VectorBucketName}-{AccountID}.tosvectors-cn-beijing.volces.com​
Authorization: authorization string​
Date: Wed, 10 Dec 2025 12:49:14 GMT​
​
{​
    "vectorBucketName": "test-vector-bucket",​
    "indexName": "test-index",​
    "vectors": [​
        {​
            "key": "key0",​
            "metadata": {​
                "key_a": "va",​
                "key_b": "vb",​
                "key_c": "vc"​
            },​
            "data":{​
                "float32": [0.1, 0.1, 0.1, 0.1, 0.1]​
            }​
        },​
        {​
            "key": "key1",​
            "metadata": {​
                "key_a": "va",​
                "key_b": "vb",​
                "key_c": "vc1",​
                "key_d": "vd"​
            },​
            "data":{​
                "float32": [0.2, 0.2, 0.2, 0.2, 0.2]​
            }​
        }​
    ]​
}​

请求参数和消息头

无。

请求元素

名称	参数类型	是否必选	示例值	说明
vectorBucketName	string	是	test-vector-bucket	向量桶名称。
indexName	string	是	test-index	向量索引名称。
vectors	PutInputVector[]	是	参见下表	要添加到向量索引的向量数组。单个请求中的向量数量不能超过资源容量（最少 1 个，最多 500 个），否则请求将被拒绝并返回 ServiceUnavailableException 错误。

PutInputVector 结构体参数说明：

名称	参数类型	示例值	说明
data	VectorData	"float32": [0.1, 0.1, 0.1, 0.1, 0.1]	向量数据。确保查询向量的维度与被查询的向量索引的维度相同。
key	string	key0	向量的唯一标识符。
metadata	JSON value	{ "key_a": "va", "key_b": "vb", "key_c": "vc" }	与向量关联的元数据，用户自定义 KV 组成的 Map。

VectorData 结构体是 Union 类型，当前只有一个成员有效（float32），参见下表。

名称	参数类型	说明
float32	float32[]	向量数据。该向量维度必须和 CreateIndex 中定义的向量索引维度一致。

响应消息头

返回公共的响应头，请参见公共参数。

响应元素

如果操作成功，服务将返回一个 HTTP 200 响应且响应元素为空。

如果操作失败，返回响应码中定义的错误码。

请求示例

POST /PutVectors HTTP/1.1​
Host: test-vector-bucket-1111.tosvectors-cn-beijing.volces.com​
Authorization: authorization string​
Date: Wed, 10 Dec 2025 12:49:14 GMT​
{​
    "vectorBucketName": "test-vector-bucket",​
    "indexName": "test-index",​
    "vectors": [​
        {​
            "key": "key0",​
            "metadata": {​
                "key_a": "va",​
                "key_b": "vb",​
                "key_c": "vc"​
            },​
            "data": {​
                "float32": [0.1, 0.1, 0.1, 0.1, 0.1]​
            }​
        },​
        {​
            "key": "key1",​
            "metadata": {​
                "key_a": "va",​
                "key_b": "vb",​
                "key_c": "vc1",​
                "key_d": "vd"​
            },​
            "data": {​
                "float32": [0.2, 0.2, 0.2, 0.2, 0.2]​
            }​
        }​
    ]​
}​

响应示例

HTTP/1.1 200 OK​
x-tos-id-2: 797014003c90a9b6940****-b15a995-1vV80n-CVB-cb-tos-1az-front-azd-vectors-2​
x-tos-request-id: 797014003c90a9b6940****-b15a995-1vV80n-CVB-cb-tos-1az-front-azd-vectors-2​
Date: Wed, 10 Dec 2025 12:49:14 GMT​
Server: TosServer​
Content-Length: 0​

最近更新时间：2026.09.18 14:23:38

这个页面对您有帮助吗？

有用

无用