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

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

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

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

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

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

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

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

5. 如何判断使用的控制台版本是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。

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

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

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

7. 为什么访问数据库出现以下报错提示：“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访问该数据集。“？
   APIV1/V2已于2025年10月17日0点后进行强隔离，API V2创建的数据集无法通过API V1进行操作，API V1创建的数据集无法通过API V2进行操作，可以按照用户实际情况选择更换为都使用V2操作或都使用V1操作（V1版本不再维护更新，推荐使用V2版本），详情可参考：API V1/V2使用隔离