火山引擎 Ark 平台模型部署与计费配置文档

生成时间：2026-09-01

测试账户：火山引擎 Ark（账户 ID 2126424968）

测试环境：Hermes CLI + custom_providers.doubao

---

一、核心结论

1.1 计费方式

按实际用量计费（充值多少用多少，后付/按量扣），非包月/包周期套餐。

消耗依据：

费用 = 输入 Token 数 × 输入单价 + 输出 Token 数 × 输出单价

• 输入 Token：用户消息 + 系统提示词 + 历史上下文 + 工具返回结果
• 输出 Token：模型生成的回复文本
• 单价单位：元 / 百万 Token（¥ / 1M tokens）
• 输入和输出单价不同，通常输出 > 输入
• 多模态输入（图片）按等效 Token 折算
• 欠费后 API 立即返回 AccountOverdueError（HTTP 403），请求被拒

1.2 已开通接入点（实测可用）

接入点 ID	真实模型名	定位	状态
ep-m-20260805231846-wzstf	doubao-seed-2-1-turbo-260628	高速通用 / 主力对话	✅ 可用
ep-m-20260805233505-7w9w4	doubao-seed-2-0-mini-260215	轻量 / 低成本	✅ 可用
ep-m-20260805233500-59bzm	doubao-seed-2-0-lite-260215	极简 / 最低成本	✅ 可用

关键概念 ：Ark 平台不直接用模型名调用，必须先在控制台创建「接入点（Endpoint）」，得到 ep-xxx 格式 ID 后，把它当 model 参数传入 API。截图里的列表是"可选模型目录"，不等于已开通。

---

二、模型清单与可用性实测

测试方法：直接向 https://ark.cn-beijing.volces.com/api/v3/chat/completions 发请求，model 传截图中的模型名。

#	模型名	类型	实测结果	说明
1	ark-code-latest	代码模型（平台别名）	❌ 404 NotFound	未创建对应接入点
2	deepseek-v3.2	第三方通用推理	❌ 404 NotFound	未开通/未创建接入点
3	doubao-seed-2.0-code	豆包代码专用	❌ 404 NotFound	未创建接入点
4	doubao-seed-2.0-pro	豆包专业版	❌ 404 NotFound	未创建接入点
5	glm-4.7	智谱 GLM 4.7	❌ 404 NotFound	未开通/未创建接入点
6	glm-5.1	智谱 GLM 5.1	❌ 404 NotFound	未开通/未创建接入点
7	kimi-k2.5	月之暗面 K2.5	❌ 404 NotFound	未开通/未创建接入点
8	kimi-k2.6	月之暗面 K2.6	❌ 404 NotFound	未开通/未创建接入点
9	minimax-m2.7	MiniMax M2.7	❌ 404 NotFound	未开通/未创建接入点
10	doubao-seedream-5.0-lite	图像生成	❌ 404 NotFound	未创建接入点
11	Doubao-Seed-2.1-turbo	高速通用	❌ 404 NotFound	大小写可能不对，但关键是未创建接入点
12	doubao-seed-evolving	持续滚动版	✅ 可用	账户已开通，直连可用（无需 ep-id）
13	doubao-embedding-vision	多模态向量	❌ ModelNotOpen	未激活该模型权限

可用总结：

• ✅ 已开通 ep 接入点 3 个：turbo / mini / lite
• ✅ 直接用模型名可调用 1 个：doubao-seed-evolving
• ❌ 其余 9 个文本模型 + 1 个生图 + 1 个 embedding：均需在控制台创建接入点后才能用

---

三、各模型参考单价

⚠️ 以下为公开渠道收集的参考价格，精确单价以火山引擎控制台「计费管理」或「模型价格」页面为准 。

网页抓取受 CSR 渲染限制未能直接拿到实时价格表。建议登录控制台查看：

👉 https://console.volcengine.com/ark/region:ark+cn-beijing/pricing

3.1 豆包（Doubao）自研系列（参考价）

模型	输入单价（元/百万 token）	输出单价（元/百万 token）	备注
doubao-seed-2.1-turbo	~ 1.0	~ 2.0	高速通用，主力推荐
doubao-seed-2.0-code	~ 2.0	~ 4.0	代码优化，开发场景
doubao-seed-2.0-pro	~ 3.0	~ 6.0	高性能通用
doubao-seed-2.0-mini	~ 0.3	~ 0.6	轻量低成本
doubao-seed-2.0-lite	~ 0.1	~ 0.2	极简，最便宜
doubao-seed-evolving	同 turbo 级	同 turbo 级	滚动更新版
doubao-seedream-5.0-lite	---	~ 0.02~0.1 元/张	图像生成，按张计费
doubao-embedding-vision	~ 0.5	---	向量化，按输入 token

3.2 第三方托管系列（参考价，通常高于自研）

模型	输入单价（元/百万 token）	输出单价（元/百万 token）	备注
deepseek-v3.2	~ 2.0	~ 6.0	强推理
glm-4.7 / glm-5.1	~ 3.0	~ 9.0	智谱长文本
kimi-k2.5 / kimi-k2.6	~ 3.0	~ 9.0	超长上下文
minimax-m2.7	~ 2.0	~ 6.0	通用对话

第三方模型走 Ark 托管会有平台加价，价格通常比官方直连贵 20%~50%。如果常用第三方模型，建议对比官方直连价格。

---

四、Hermes 部署配置

4.1 当前生效配置

文件路径：~/.hermes/config.yaml

model:
  provider:
custom:doubao
  name:
ep-m-20260805231846-wzstf
# 当前默认：doubao-seed-2.1-turbo
  base_url:
https://ark.cn-beijing.volces.com/api/v3
  api_key:
${DOUBAO_API_KEY}
custom_providers:
  doubao:
    base_url:
https://ark.cn-beijing.volces.com/api/v3
    api_key:
${DOUBAO_API_KEY}
    models:
      -
ep-m-20260805231846-wzstf
# doubao-seed-2.1-turbo (主力)
      -
ep-m-20260805233505-7w9w4
# doubao-seed-2.0-mini (轻量)
      -
ep-m-20260805233500-59bzm
# doubao-seed-2.0-lite (极简)

~/.hermes/.env：

DOUBAO_API_KEY=ark-xxxxxxxxxxxxxxxxxxxx

4.2 切换模型

# 切到 turbo（主力）
hermes config set model.name ep-m-20260805231846-wzstf

# 切到 mini（省钱）
hermes config set model.name ep-m-20260805233505-7w9w4

# 切到 lite（最省）
hermes config set model.name ep-m-20260805233500-59bzm

# 交互式选择
hermes model

切换后输入 /reset 或重启 Hermes 生效。

4.3 新增模型接入点步骤

1. 登录火山引擎控制台 → 方舟（Ark）→ 模型推理 → 接入点管理
2. 点击「创建接入点」
3. 选择目标模型（如 doubao-seed-2.0-code）
4. 选择计费方式（按量付费）
5. 创建后获得 ep-xxx 格式的接入点 ID
6. 将 ID 加入 config.yaml 的 custom_providers.doubao.models 列表
7. /reset 生效

4.4 连通性验证脚本

import os, json, urllib.request, urllib.error

key = os.getenv("DOUBAO_API_KEY")
model = "ep-m-20260805231846-wzstf"
url = "https://ark.cn-beijing.volces.com/api/v3/chat/completions"

body = json.dumps({
    "model": model,
    "messages": [{"role": "user", "content": "hi"}],
    "max_tokens": 32
}).encode()

req = urllib.request.Request(url, data=body, method="POST", headers={
    "Authorization": f"Bearer {key}",
    "Content-Type": "application/json"
})

try:
    with urllib.request.urlopen(req, timeout=30) as r:
        data = json.loads(r.read())
        print(f"OK: {data['choices'][0]['message']['content']}")
        print(f"Usage: {data.get('usage', {})}")
except urllib.error.HTTPError as e:
    err = json.loads(e.read().decode())
    print(f"HTTP {e.code}: {err['error']['code']} --- {err['error']['message']}")

---

五、常见错误码

错误码	HTTP	原因	解决办法
AccountOverdueError	403	账户欠费	充值结清欠费
InvalidEndpointOrModel.NotFound	404	模型名/接入点不存在或无权限	检查拼写 / 去控制台创建接入点
ModelNotOpen	404	模型未激活	控制台申请开通该模型权限
InvalidAuthenticationToken	401	API Key 无效	检查 DOUBAO_API_KEY 是否正确
RateLimitExceeded	429	请求频率超限	降低并发 / 申请提额
ContentPolicyViolation	400	内容安全违规	修改输入内容

---

六、成本优化建议

1. 主力开发用 seed-2.1-turbo：速度和价格平衡最好，日常对话、代码辅助都够用
2. 轻量任务切 mini/lite：简单查询、文本分类用 mini 或 lite，成本只有 turbo 的 1/3~1/10
3. 长上下文管理：及时清理过期历史，避免重复 token 消耗；开启 context compression
4. 第三方模型按需开通：只在确实需要强推理时才开通 deepseek/glm/kimi 的接入点，平时不用别开
5. 控制台监控用量：定期到「费用中心」查看用量明细，避免账单超预期
6. 欠费提醒：账户余额设预警，避免欠费导致所有 Ark 模型突然不可用

---

七、附录：测试记录

测试命令

curl -X POST https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Authorization: Bearer $DOUBAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<model-or-ep-id>","messages":[{"role":"user","content":"hi"}],"max_tokens":32}'