如何通过HTTP API新建Collection
2026/6/30 2:57:08 网站建设 项目流程

使用示例

说明

需要使用您的api-key替换示例中的YOUR_API_KEY、您的Cluster Endpoint替换示例中的YOUR_CLUSTER_ENDPOINT,代码才能正常运行。

创建单向量集合

Shell

# 创建一个名称为quickstart、向量维度为4、 # 向量数据类型为float(默认值)、 # 距离度量方式为dotproduct(内积)的Collection # 并预先定义八个Field,名称为name、weight、age、id、tags、numbers、bankCards、grades,数据类型分别为string、float、int、long、ARRAY_STRING、ARRAY_INT、ARRAY_LONG、ARRAY_FLOAT curl -XPOST \ -H 'dashvector-auth-token: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "quickstart", "dimension": 4, "metric": "dotproduct", "fields_schema": { "name": "STRING", "age": "INT", "weight": "FLOAT", "id": "LONG", "tags":"ARRAY_STRING", "numbers":"ARRAY_INT", "bankCards":"ARRAY_LONG", "grades":"ARRAY_FLOAT" } }' https://YOUR_CLUSTER_ENDPOINT/v1/collections # example output: # {"request_id":"19215409-ea66-4db9-8764-26ce2eb5bb99","code":0,"message":""}

创建多向量集合

curl -XPOST \ -H 'dashvector-auth-token: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "multi_vector_demo", "vectors_schema": { "title": { "dimension": 4 }, "content": { "dimension": 6, "metric": "dotproduct" } }, "sparse_vectors_schema": { "abstruct": { "metric": "dotproduct" }, "keywords": { "metric": "dotproduct" } # 稀疏向量索引目前仅支持内积度量,dimension/dtype使用默认值无需设置 }, "fields_schema": { "author": "STRING" } }' https://YOUR_CLUSTER_ENDPOINT/v1/collections # example output: # {"request_id":"819b6ffe-bf44-42a4-8efa-a53a93d93bcd","code":0,"message":""}

入参描述

参数Location类型必填说明
pathstrCluster的Endpoint,可在控制台Cluster详情中查看
dashvector-auth-tokenheaderstrapi-key
namebodystr待创建的Collection名称
dimensionbodyint向量维度,取值范围 (1, 20000\]
dtypebodystr向量数据类型,"FLOAT"(默认)/"INT"
fields\_schemabodyobjectFields定义
metricbodystr距离度量方式,"euclidean"/"dotproduct"/"cosine"(默认) 值为cosine时,dtype必须为FLOAT
extra\_paramsbodyobject可选参数: - quantize\_type:量化策略,详情参考向量动态量化 - auto\_id: 自动生成主键,默认开启
vectors\_schemabodyobject多个向量字段定义,类型为Map<String, VectorParam>,详情参考多向量检索
sparse\_vectors\_schemabodyobject多个稀疏向量字段定义,类型为Map<String, VectorParam>,详情参考多向量检索

说明

  • 创建Collection时预先定义Fields的收益见Schema Free

  • 量化策略详情可参考向量动态量化

出参描述

字段类型描述示例
codeint返回值,参考返回状态码说明0
messagestr返回消息success
request\_idstr请求唯一id19215409-ea66-4db9-8764-26ce2eb5bb99

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询