OpenCode Zen 网关 (OpenCode Zen Gateway)

2026-08-19 暂无评论

OpenCode Zen 是 OpenCode 官方的付费 AI 模型网关（AI gateway），提供统一入口访问 Claude / GPT / Gemini / DeepSeek / GLM / Kimi / Qwen / Grok 等各家模型，按请求计费、可充值余额。等价于一个 OpenAI 兼容的聚合 API 服务。

关键信息

产品页：https://opencode.ai/zen
文档：https://opencode.ai/docs/zen/
API Base URL：https://opencode.ai/zen/v1（OpenAI 兼容）；/zen/go/v1 前缀同样可用（真实存在的端点走这个前缀）
- 注意：https://opencode.ai/zen/go 裸路径是 404，但 /zen/go/v1/... 是有效的 API 前缀
认证：Authorization: Bearer <API Key>
使用流程：登录 opencode.ai → Zen → 填 billing → 复制 API key → 在 OpenCode TUI 里 /connect 粘贴

常用端点

端点	用途
`GET /zen/v1/models`	列出全部 62 个模型（含各家旗舰）
`POST /zen/v1/chat/completions`	OpenAI 聊天补全
`POST /zen/v1/responses`	OpenAI Responses API（文档主推，配 @ai-sdk/openai）
`POST /zen/v1/messages`	Anthropic Messages 兼容

Usage / 账单

用量查询 API 存在：GET https://opencode.ai/zen/go/v1/usage，Bearer 认证。返回三个窗口的限额用量百分比：

{"usage":{"rolling":{"status":"ok","percent":5,"resetsAt":"2026-08-18T22:56:01Z"},
 "weekly":{"status":"ok","percent":2,"resetsAt":"2026-08-24T00:00:00Z"},
 "monthly":{"status":"ok","percent":1,"resetsAt":"2026-09-13T05:24:39Z"}}}

rolling = 滚动窗口（约 24h），weekly / monthly 分别为周 / 月窗口；percent 是已用限额百分比，resetsAt 为重置时间。
这是限额用量（rate limit），不是账单金额。

没有 balance / billing / credits 查询端点：/zen/go/v1/balance、/billing、/credits 等均 404；api.opencode.ai 只是 "Hello, world!" 占位。余额、充值、月度限额设置在 opencode.ai 网页 dashboard（登录后）。
每个模型调用响应里会返回标准 usage 字段（prompt/completion/total tokens、缓存命中、reasoning tokens），可用免费模型验证 key 是否有效，零成本。

免费模型（验证 key / 测试用）

deepseek-v4-flash-free、mimo-v2.5-free、hy3-free、nemotron-3-ultra-free、nemotron-3.5-lightning-free、laguna-s-2.1-free、big-pickle（限时免费）

验证示例

curl https://opencode.ai/zen/v1/chat/completions \
  -H "Authorization: Bearer sk-..." -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash-free","messages":[{"role":"user","content":"say hi"}],"max_tokens":8}'

注意：max_tokens 过小时会被 reasoning tokens 吃满，content 可能为空——这是正常的。