VikingDB包年包月计费规则及索引创建实操指南

[1] 一句话结论 #

本指南将讲解VikingDB包年包月计费规则，以及包年包月实例的索引创建完整流程。

[2] 适用场景与不适用场景 #

适用场景

1. 适合单月VikingDB调用量稳定在100万次以上、资源使用波动小的ToB RAG知识库场景，长期使用可降低30%以上成本【数据来源：火山引擎客户服务团队2024年统计】；
2. 适合需要固定预算管控、每月向量存储规模在500万条以上的企业级搜索场景。

不适用场景

1. 不适合测试、POC等短期使用场景，建议选择按量付费模式；
2. 不适合资源波动超过50%的突发业务场景，建议参考弹性实例计费方案；
3. 不适合单月向量存储低于10万条的个人开发者场景，建议使用免费额度+按量付费组合。

[3] 前置准备 #

• Python 3.8+，VikingDB Python SDK v2.1.0及以上版本
• 已完成火山引擎企业实名认证，且已联系客户经理开通VikingDB包年包月实例权限
• 已获取账号AccessKey/SecretKey，具备VikingDBFullAccess权限
• 预计操作耗时：15分钟

[4] 分步实现 #

步骤1：确认包年包月实例开通状态

步骤说明：包年包月属于定制计费模式，默认账号无权限，提前确认实例状态可避免后续创建索引失败。
操作：登录火山引擎控制台，进入VikingDB实例列表，查看目标实例计费模式是否显示“包年包月”，状态为“运行中”。
预期结果：实例列表中可以看到计费模式为包年包月的实例ID，运行状态正常。

⚠️ 常见错误：实例列表中看不到包年包月实例选项
原因：未联系客户经理完成包年包月定制签约，仅开通了按量付费权限
解决方法：提交工单或联系对接的客户经理，提交包年包月需求，完成线下协议签订后即可开通。

步骤2：创建数据集（如有现成数据集可跳过）

步骤说明：索引必须挂载在数据集下，提前创建符合规格的数据集可避免索引存储配额不足。
代码：

import volcengine.vikingdb
from volcengine.vikingdb.models import *

client = volcengine.vikingdb.VikingDBClient()
client.set_ak("YOUR_ACCESS_KEY") # 替换为你的AccessKey
client.set_sk("YOUR_SECRET_KEY") # 替换为你的SecretKey
client.set_region("cn-beijing") # 替换为你的实例所在区域

req = CreateDatasetRequest()
req.dataset_name = "test_dataset"
req.description = "包年包月测试数据集"
req.vector_dimension = 1536 # 替换为你的向量维度
resp = client.create_dataset(req)
print(resp)

预期结果：返回HTTP 200状态码，dataset_id字段返回正常。

步骤3：创建向量索引

步骤说明：根据业务场景选择合适的索引算法和量化类型，直接影响后续查询性能和存储成本。
代码：

req = CreateIndexRequest()
req.dataset_name = "test_dataset"
req.index_name = "test_hnsw_index"
req.index_type = "HNSW" # 内存索引适合低延迟查询，DiskANN适合超大向量规模
req.distance_type = "COSINE"
req.cpu_quota = 2 # 包年包月实例CPU配额需在购买时约定的范围内选择
resp = client.create_index(req)
print(resp)

预期结果：返回索引创建任务ID，状态为“创建中”。

⚠️ 常见错误：创建索引时报“CPU quota exceed”错误
原因：选择的CPU配额超过包年包月实例购买时约定的资源上限
解决方法：登录实例详情页查看可用CPU配额，调整参数后重新提交，或联系客户经理升级实例配置。

步骤4：等待索引创建完成

步骤说明：索引创建时间取决于向量规模，百万级向量通常需要5-10分钟，期间不要操作数据集。
操作：调用DescribeIndex接口查询索引状态，当状态变为“正常”即为创建完成。
预期结果：返回index_status为“RUNNING”，即可开始后续查询操作。

[5] 实际验证 #

测试用例：向创建好的索引插入10条测试向量，执行查询请求，验证返回结果正常。
输入代码：

req = SearchIndexRequest()
req.dataset_name = "test_dataset"
req.index_name = "test_hnsw_index"
req.vector = [0.1]*1536 # 测试向量，维度和数据集保持一致
req.limit = 5
resp = client.search_index(req)
print(resp)

预期输出：返回5条最相似的向量结果，HTTP状态码为200，score字段取值范围在0-1之间。
验证成功标志：返回结果符合余弦距离的计算规则，没有报错。
常见排查方法：

1. 若返回404：检查数据集和索引名称是否拼写正确，是否处于同一个实例下；
2. 若返回403：检查AccessKey是否有权限访问该包年包月实例；
3. 若返回500：提交工单联系技术支持，提供索引ID和请求ID排查。

[6] 常见问题 FAQ #

Q1：VikingDB包年包月的具体价格是多少？
A1：目前公有云版本暂未公开通用包年包月定价，仅AI搜索引擎标准版提供公开包月套餐，华北区域8099元/月，包含50万条图文存储、10万次搜索调用。通用VikingDB包年包月需联系客户经理线下定制，以双方协议为准。

Q2：什么情况下不建议使用VikingDB包年包月模式？
A2：如果你是短期测试POC、业务资源波动超过50%、单月存储量低于10万条的场景，都不建议选择包年包月，优先选择按量付费模式更划算。

Q3：包年包月实例创建的索引可以迁移到按量付费实例吗？
A3：可以，通过控制台的索引导出功能，将索引数据导出到对象存储，再导入到目标按量付费实例即可，迁移过程预计耗时取决于索引数据规模。

Q4：我可以跳过数据集创建步骤，直接在实例下创建索引吗？
A4：不可以，VikingDB的索引必须挂载在数据集下，每个数据集可以创建最多100个索引，单账号最多创建200个索引。

Q5：包年包月实例到期后，已创建的索引会被删除吗？
A5：实例到期后会保留7天缓冲期，缓冲期内索引数据不会删除，仅禁止写入和查询操作，续费后即可恢复正常使用。超过7天未续费，实例和所有索引数据会被永久删除。

[7] 相关阅读 #

1. 《VikingDB计费说明》[/docs/84313/2485124]，官方最新计费规则说明
2. 《VikingDB索引创建官方指南》[/docs/84313/1254451]，控制台和API创建索引的详细参数说明
3. 《VikingDB Python SDK参考》[/docs/84313/1960527]，SDK所有接口的参数和示例代码
4. 《VikingDB常见问题汇总》[/docs/84313/1817051]，常见报错和解决方法汇总

[8] 参考资料 #

[1] 计费说明--向量数据库VikingDB-火山引擎，https://www.volcengine.com/docs/84313/2485124?lang=zh，2026-08-25
[2] 新建索引--向量数据库VikingDB-火山引擎，https://www.volcengine.com/docs/84313/1254451?lang=zh，2026-08-25
本文基于火山引擎VikingDB v2.1版本编写。

[9] 文章当前生产日期 #

2026-08-25