文档中心

向量数据库VikingDB

请输入

常见问题

V2／V1使用问题

新版不好用，我如何回滚到旧版API？

页面上可以通过点击切换返回旧版本。同时在接口层面仍可通过原 API 接口调用。也欢迎将不好用的问题进行反馈，我们会持续优化。

API V2和API V1相比提升在哪？

API V2 相比于 V1 的区别在于 V2 支持更丰富的功能，包括但不限于视频数据写入及检索、多关键词检索等；同时 V2 接口按照数据面和控制面划分，更加便于用户理解和使用。可参考上方文档介绍，从新功能特性、接口易用性等角度了解。

我是新用户，如何使用API V2？

对于新用户默认在新版页面，直接按照页面使用即可。

现在的最佳实践能参考吗？

目前的快速入门和最佳实践仍然是以旧版API V1实现的，后续我们会陆续更新。

如何判断使用的控制台版本是API V1还是API V2？

以数据集入口链接为例，API V2 的页面链接与 API V1 的页面链接的区别在于：V2 域名路径中增加了 bohr，其他页面类似。
V1入口：https://console.volcengine.com/vikingdb/region:vikingdb+cn-beijing/collection/list
V2入口：https://console.volcengine.com/vikingdb/region:vikingdb+cn-beijing/bohr/collection/list
可根据此判断控制台版本是V1还是V2。

为什么我在控制台找不到我创建的向量数据库？

这种情况有可能是因为当前控制台的版本和创建向量库所使用的API版本不一致。控制台仅展示其对应版本API所创建的向量数据库：点击下图页面位置，可以切换控制台版本。

切换后如果可以找到创建的向量数据库，则说明建库使用的 API 版本和控制台版本不一致，需统一使用版本（V1 版本不再维护更新，推荐使用 V2 版本）；切换后如果还是找不到创建的向量数据库，可以联系我们或发起 Oncall 解决。

为什么访问数据库出现以下报错提示：“This collection was created by API V2, but you are accessing it via API V1. Please switch to access this collection via API V2. 该数据集是由 API V2 创建的，但您正在通过 API V1 访问它。请切换至 API V2 访问该数据集。”？
API V1/V2 已于 2025 年 10 月 17 日 0 点后进行强隔离：API V2 创建的数据集无法通过 API V1 进行操作，API V1 创建的数据集无法通过 API V2 进行操作。可以按照用户实际情况选择更换为都使用 V2 操作或都使用 V1 操作（V1 版本不再维护更新，推荐使用 V2 版本），详情可参考：API V1/V2使用隔离

最近更新时间：2026.09.08 12:02:52

这个页面对您有帮助吗？

有用

无用