OpenCode Zen

Zen 是 OpenCode 提供的可选按量付费模型服务。你可以把它作为提供商连接，也可以继续使用其他提供商。OpenCode 客户端免费不代表托管推理免费。

连接与选择模型

1. 登录官方控制台 (opens in a new tab)，确认账单设置后复制 API 密钥。
2. 在 TUI 中运行 /connect，选择 OpenCode Zen 并输入密钥，不要提交凭据。
3. 运行 /models 选择可用模型，先测试不含敏感数据的小请求，再核对控制台用量。

Zen 模型标识使用 opencode/<model-id>，ID 应取自实时模型目录 (opens in a new tab)，不能根据厂商名称猜测。需要固定默认模型时，在配置的 model 中填写已确认的完整标识。

连接 Zen 后，以下项目配置选择 GPT 5.5，也可以从表中选择其他可用 ID。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5"
}

协议与直接 API

Zen 的 API 前缀为 https://opencode.ai/zen/v1/。模型可能使用 OpenAI 适配器对应的 responses、Anthropic 适配器对应的 messages、OpenAI 兼容适配器对应的 chat/completions，Google 模型还有自己的模型端点。请依照下方模型端点表逐模型选择；内置 Zen 连接会处理映射，不要把所有模型都送到同一个 Chat Completions 端点。

Jev 通过 https://opencode.ai/zen/v1/systemone 返回结构化决策，而非生成文本；问题类型包括 noul、choice 和 score。当前模型 ID 与响应结构参阅下方 Jev 示例。

模型清单与端点

下表列出 Zen 的模型 ID、端点和令牌价格。可用性请以实时目录为准：参考表中保留的部分模型已经停用。opencode/ 前缀用于客户端配置；直接调用 API 时使用不带该前缀的模型 ID。

Jev

在终端环境中将 OPENCODE_API_KEY 设置为 Zen 密钥。示例让 Jev 判断请求是否紧急，noul 表示是非问题；命名选项用 choice，分级评估用 score。该示例调用付费模型，会产生请求费用。

curl https://opencode.ai/zen/v1/systemone \
  -H "Authorization: Bearer $OPENCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "My payments have failed for three days and I am losing sales. Please help now.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this request require urgent attention?"
      }
    }
  }'

价格与支出控制

输入、输出、缓存、长上下文及支付处理费用，以下方令牌价格表和控制台为准。免费模型可能限时开放且有不同数据条款；停用模型应按当前目录核对，不能依赖旧示例。会话标题生成也可能在用量中显示为较小模型的调用。

自动充值会在余额低于阈值时向付款方式扣费。充值金额可调整，也可以关闭。无人值守运行前先确认账户实际设置。

月度使用限额限制工作区或成员的消费量，并不等于付款交易上限：自动充值的扣款可能超过消费限额。应同时查看余额、自动充值与使用限额。

令牌价格

价格单位为美元／百万令牌。输入、输出、缓存读取和缓存写入分别计费；存在上下文分档时按表中档位计算。短横线不表示免费。图片输入也可能产生令牌费用，包括 DeepSeek V4 Flash Vision Exp。

免费模型

以下模型提供免费额度或限时免费服务，可用性和数据条款各不相同，不代表无限量或永久免费。Jev 返回结构化决策，不能代替生成文本的编码模型。

• Big Pickle
• MiMo-V2.5 Free
• Ling 3.0 Flash Fin Free
• Nemotron 3 Ultra Free
• Nemotron 3.5 Lightning Free
• Muse Spark 1.3 Contributor Free
• Jev 1.13 Free

费用计算示例

以 MiniMax M3 为例，10 万个未命中缓存的输入令牌及 2 万个输出令牌，费用为 0.1 × $0.30 + 0.02 × $1.20 = $0.054，未计其他费用。重试和重复提交上下文会增加用量。支付处理费列为每笔 4.4% + $0.30，实际扣款请在控制台确认。

自动充值

如果你的余额低于 $5,Zen 将自动充值 $20。

你可以更改自动充值金额,也可以完全禁用自动充值。

月度限额

你还可以为整个工作区以及团队中的每位成员设置月度使用限额。

例如,假设你将月度使用限额设置为 $20,那么 Zen 在一个月内的使用金额不会超过 $20。但如果你启用了自动充值,当余额低于 $5 时,Zen 最终向你收取的金额可能会超过 $20。

已停用模型

隐私

针对所选模型阅读当前隐私说明 (opens in a new tab)。上游介绍了美国托管和包含例外的数据保留规则，不能概括成所有模型都零保留。

不同模型的规则包括 OpenAI 与 Anthropic API 的保留期限、部分免费模型可能将数据用于改进、NVIDIA 免费端点的试用日志以及 Muse Spark Contributor 的训练用途。NVIDIA 试用说明明确要求不要提交个人或机密数据。发送私有代码前应核实具体模型条款与有期限的协议。

团队与自带密钥

Admin 可管理模型、成员、API 密钥和账单；Member 仅管理自己的密钥。管理员可设置成员消费限额、禁用模型；请求被禁用模型会报错，不应直接认定密钥损坏。临时免费工作区安排不等于永久免费。

Zen 支持使用自己的 OpenAI 或 Anthropic 密钥；采用该选项时，对应令牌由提供商直接计费，而非 Zen。对账或调整限额前先确认实际计费账户。

角色

你可以邀请队友加入工作区并分配角色:

• Admin :管理模型、成员、API 密钥和账单
• Member :仅管理自己的 API 密钥

Admin 还可以为每位成员设置月度支出限额,以便控制成本。

模型访问

Admin 可以为工作区启用或禁用特定模型。向已禁用模型发出的请求会返回错误。

这在你想禁用会收集数据的模型时很有用。

自带密钥

你可以使用自己的 OpenAI 或 Anthropic API 密钥,同时仍然访问 Zen 中的其他模型。

当你使用自己的密钥时,tokens 由提供商直接计费,而不是由 Zen 计费。

例如,你的组织可能已经拥有 OpenAI 或 Anthropic 的密钥,并且你想使用它,而不是使用 Zen 提供的密钥。

排查问题

401/403 先查密钥、工作区和模型权限；模型不可用查准确 ID 与停用状态；额度错误查看余额和消费设置。连接问题参阅网络与故障排查。

相关指南

• 提供商配置
• 模型选择
• 网络设置
• 故障排查

文档来源（MIT）