全部文档
当前文档
最近更新时间：2026-11-04 15:39:19
向量存储桶(KS3 Vectors)专门用于存储、查询和管理大规模向量数据，面向多模态检索、知识库、RAG、AI Agent 等 AI 场景提供向量存储与向量查询能力。
目前支持北京地域，底层默认采用同城冗余，更多地域敬请期待。
低成本:仅根据向量数据存储量和检索扫描数据量计费，较传统向量数据库方式成本更低。
大规模:弹性扩缩容架构，承载海量向量数据，单索引最高 5000 万条。
简单易用:支持通过 API、SDK、KS3Util 工具、控制台进行管控及向量数据读写。
统一管理:与普通桶同属对象存储服务，采用一套 API 管理，无需跨系统。
语义检索:提供 QueryVectors 接口按相似性返回 TopK 结果，支持元数据过滤。
服务稳定可靠：可提供99.9999999999%（12个9）的数据可靠性保障。
RAG 企业知识库:将 PDF/Word 等文档向量化存储，检索相关上下文供大模型生成。
AI Agent 记忆存储:保留长期交互记忆与历史上下文，支撑持续学习。
语义搜索与多媒体索引:应用于电商找同款、医疗影像相似度、UGC/AIGC 内容查重等场景。
分层向量存储:热数据导出到 OpenSearch 做高性能查询，冷数据留在向量桶做低成本存储。
术语 | 说明 |
向量(Vector) | 原始数据(文本/图片/视频)经 AI 嵌入模型转换后得到的浮点数组，用于让计算机快速判断数据相似度 |
向量维度 | 一个向量中包含的数值元素个数，即向量长度。如 768 个数值组成即为 768 维，决定信息表达复杂度。范围 1~4096 |
向量数据类型 | 每个向量元素的数值格式，当前仅支持 float32 |
向量索引(Index) | 存储和管理向量数据的索引表，定义维度和距离计算方式，支持相似性检索 |
距离度量函数 | 衡量两向量相似程度的数学函数，支持余弦距离(cosine)和欧氏距离(euclidean)两种 |
余弦距离 | 通过两向量夹角的余弦值衡量相似度，关注方向而非长度。距离 = 1 - 余弦相似度，取值 [0，2]，越小越相似，适合高维语义检索 |
欧氏距离 | 多维空间中两点的直线距离，关注数值差异，距离 ≥0，越小越相似，适合低维数值检索 |
元数据(Metadata) | 为向量附加的辅助性键值对信息，用于关联原始数据、过滤检索 |
可筛选元数据 | 参与相似性检索过滤条件判断的元数据，总大小 ≤2 KB |
不可筛选元数据 | 不参与过滤、仅存储业务描述信息的元数据，字段数 ≤10 个 |
向量主键(Key) | 唯一标识一条向量数据的字段 |
向量存储桶采用三级资源结构:向量存储桶 → 向量索引 → 向量。
向量存储桶 (Vector Bucket)
│ 顶层容器，隔离权限、区域、计费
├── 向量索引 (Vector Index) 每桶最多 100 个
│ │ 定义维度和距离计算方式
│ └── 向量数据 (Vector) 每索引最多 5000 万条
│ ├── Key 唯一标识(1~1024 字符)
│ ├── Vector Data 浮点数组，维度 1~4096
│ └── Metadata 元数据，支持过滤公测期间免费使用，需通过工单或商务经理提交测试申请，添加白名单。
限制项 | 约束 |
单账号单地域向量桶数 | 最多 100 个 |
桶名长度 | 3~63 字符 |
桶名字符 | 仅小写字母(a-z)、数字(0-9)、连字符(-) |
桶名首尾 | 必须以字母或数字开头和结尾，不能以连字符开头或结尾 |
单账号单地域桶名 | 必须唯一 |
限制项 | 约束 |
单桶向量索引数 | 最多 100 个 |
索引名长度 | 3~63 字符，仅小写字母与数字，首字母必须为字母 |
索引名 | 桶内全局唯一 |
CreateIndex QPS | 5 次/秒/桶 |
限制项 | 约束 |
单索引向量数 | 最多 5000 万条 |
向量维度 | 1~4096 维 |
检索 TopK | 默认 1~100(QueryVectors 接口 1~30) |
单向量数组大小 | 1 KB~500 KB |
单向量元数据总大小 | ≤40 KB |
单向量可筛选元数据 | ≤2 KB |
单向量不可筛选元数据字段数 | ≤10 个 |
PutVectors 单批 | ≤500 条 |
PutVectors QPS | ≤5 |
QueryVectors QPS | 30 |
GetVectors 单次 | ≤100 条 |
ListVectors 单次 | ≤1000 条 |
ListVectors 并行分段 | ≤16 |
限制项 | 约束 |
单次过滤累计长度 | ≤64 KB |
单次过滤项数量 | ≤1024 个 |
过滤条件嵌套层级 | ≤8 层 |
向量存储桶提供独立的公网和内网访问域名，与普通桶隔离，内网外网均支持 HTTPS:
类型 | 域名(北京地域示例) |
公网 | |
内网 |
KS3 签名:与 KS3 线上签名方式一致
仅支持 V4 签名，向量存储桶签名不支持匿名访问
Service Name 必须为 s3vectors
向量存储桶提供一套专用 API。各接口文档如下:
接口 | API | 说明 |
创建向量桶 | 创建向量存储桶 | |
获取向量桶详情 | 获取向量桶的详细信息 | |
列举向量桶 | 列举请求者名下所有向量桶 | |
删除向量桶 | 删除向量存储桶 |
接口 | API | 说明 |
创建向量索引 | 在向量桶中创建向量索引，定义维度和距离算法 | |
获取索引详情 | 获取向量索引的详细信息 | |
列举索引 | 列举桶中所有向量索引 | |
删除索引 | 删除向量索引 |
接口 | API | 说明 |
写入向量 | 向索引写入向量数据(单批 ≤500) | |
获取向量 | 按 key 获取指定向量(单次 ≤100) | |
列举向量 | 列举索引中所有向量(支持并行) | |
删除向量 | 删除指定向量 | |
相似性检索 | 输入查询向量返回 TopK 相似结果 |
名称 | 说明 |
|---|---|
KS3 向量桶的命令行工具 |
纯净模式