opencode2api

环境要求

• Go 1.24 或更高版本（从源码编译时）
• 已按需准备 Zen / Go 上游凭据或使用示例中的匿名免费通道
• 配置目录需可写（用于密码迁移、配置保存与模型缓存）
• 运行不需要 Node.js 运行时和数据库

安装与启动步骤

1. 1克隆仓库

   拉取源码并进入项目根目录，后续命令都在该目录执行。

   git clone https://github.com/jasonxu114514/opencode2api.git
   cd opencode2api

   复制

2. 2复制示例配置

   以 config.example.json 为模板生成 config.json，之后只改这个文件。

   cp config.example.json config.json

   复制

3. 3修改关键配置

   把 server_keys 换成自己的本地 Key，按需填 zen_keys / go_keys，并改掉 webui.password。示例使用 admin 用户名开启 WebUI。

4. 4编译二进制

   用 Go 1.24 以上版本编译，生成单文件可执行程序 opencode2api。

   go build -o opencode2api ./cmd/opencode2api

   复制

5. 5启动服务

   指定配置文件启动；示例监听 API 127.0.0.1:8080、WebUI 0.0.0.0:8081。

   ./opencode2api -config config.json

   复制

6. 6验证与取模型

   带本地 Key 请求 /v1/models，返回可用模型列表即表示网关可用；也可访问 /healthz。

   curl http://localhost:8080/v1/models -H "Authorization: Bearer sk-local-xxxxxxxx"

   复制

7. 7Windows 构建运行

   Windows 下复制配置、编译 exe 并运行，参数与 Linux 相同。

   Copy-Item config.example.json config.json
   go build -o opencode2api.exe ./cmd/opencode2api
   .\opencode2api.exe -config config.json

   复制

关键配置

如何确认成功

请求 /v1/models 能返回模型列表，且 /healthz 无需认证即返回就绪状态即可。

常见问题

注意事项

• server_keys 只用于客户端认证，绝不会被当作上游凭据使用。
• 管理端口示例绑定 0.0.0.0:8081，通过网络访问时应限制来源并置于 HTTPS 反向代理之后。
• 配置目录必须可写，否则密码迁移、配置保存和模型缓存会失败。
• API 请求体上限为 32 MiB，流式响应可在请求体加 "stream": true 并用 curl -N 观察。