Zzen·proxy
v4.0 · auto-switch
OpenCode Zen · 本地网关

一个 auto,接管全部免费模型。

单文件 Go 二进制,把 OpenCode 的免费模型变成你本地的 OpenAI 兼容网关。模型选 auto,反代自动挑当前有额度的免费模型——额度耗尽自动切换,客户端无感

$ ./zen-proxy-linux-amd64
upstream opencode.ai/zen/v1
free models 11 verified
$ model = "auto" 自动切换
200 · nemotron-3.5-lightning-free
quota exhausted · switch to next
health ok · cost 0
01

模型

n+1 模式 · auto + 全部免费模型
auto

一个模型名,11 个后端。

请求填 auto,反代在所有免费模型中自动选择当前可用者;某个模型日额度耗尽(FreeUsageLimitError),立即切换同池下一个——额度等效放大 11 倍

11
free backends
big-picklefree
deepseek-v4-flash-freefree
laguna-s-2.1-freefree
mimo-v2.5-freefree
hy3-freefree
nemotron-3-ultra-freefree
nemotron-3.5-lightning-freefree
longcat-2.0-freefree
ling-3.0-flash-freefree
ling-3.0-tiny-freefree
north-mini-code-freefree
动态探测auto refresh
02

下载

单文件 · 静态链接 · 开箱即跑
zen-proxy-go-bundle.zip
源码 · 4 平台二进制 · 分析报告 · 模型数据
9.3 MB ↓
Linux
x86_64 · amd64
zen-proxy-linux-amd645.1 MB ↓
Windows
x86_64 · .exe
zen-proxy-windows-amd64.exe5.2 MB ↓
macOS Intel
x86_64
zen-proxy-darwin-amd645.4 MB ↓
macOS Apple Silicon
arm64
zen-proxy-darwin-arm645.3 MB ↓
历史版本
v4.0 · auto-switch
n+1 模式:auto 自动切换全部免费模型(当前版本)
4 平台 ↓
v3.0 · quota-failover
配额感知:模型日额度耗尽自动切换同池模型
linux ↓
v2.0 · anti-limit
浏览器指纹伪装,绕过 Cloudflare 1010 拦截
linux ↓
注:v2 / v3 仅归档 Linux 版;完整多平台请用当前 v4.0。
03

用法

标准 OpenAI 兼容协议
bash
# 启动(默认监听 :8787)
./zen-proxy-linux-amd64

# 列出免费模型(n+1:auto + 全部免费模型)
curl http://localhost:8787/v1/models

# 对话(模型填 auto,api_key 随意)
curl http://localhost:8787/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"你好"}],"stream":true}'
python
from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8787/v1",
    api_key="任意值",
)

r = client.chat.completions.create(
    model="auto",   # 自动切换,额度耗尽无感续用
    messages=[{"role":"user","content":"你好"}],
)
print(r.choices[0].message.content)
config
# 任意 OpenAI 兼容客户端(ChatBox / OpenWebUI / Cline / AstrBot)
API Base URL : http://localhost:8787/v1
API Key      : 随意填写
模型名        : auto   # 或从 /v1/models 选任意免费模型

# 注意:客户端与反代需在同一台机器;
# 跨机请用其局域网 IP,不要填 0.0.0.0
04

突破每日免费限制

三层 · 全部默认开启

L1绕过 Cloudflare 拦截

网关架在 Cloudflare 之后,数据中心 IP + CLI 特征会被错误码 1010 拦掉。反代默认把请求伪装成真实 Chrome 指纹(UA + sec-ch-ua + Origin/Referer)。

L2配额感知自动换模型

免费额度按模型独立deepseek 耗尽后 laguna / mimo / big-pickle 完全不受影响。遇到 FreeUsageLimitError 自动切同池下一模型。

L3代理出口池(可选)

UPSTREAM_PROXIES 轮换出口 IP,进一步分散 IP 级速率限制。没代理就不配,默认配置已够用。

E环境变量

以下全部默认开启,无需配置:
ZEN_BROWSER_MODE · ZEN_RETRY_4XX · ZEN_JITTER · ZEN_FAILOVER

05

能力

透明转发 · 不改造字段

·01透明转发

原样透传 messages / tools 到上游 OpenAI 兼容协议,不解析、不改造。

·02免费锁定

free_only 模式只放行实测免费模型,误填真 key 也不会踩付费。

·03配额轮换

免费模型日额度耗尽自动切换同池模型,额度等效放大 N 倍,客户端无感。

·04工具调用

完整 Agent 闭环:请求工具 → 回传结果 → 基于结果作答。

·05原生流式

SSE 透传,tool_calls 分片流式返回,与官方一致。

·06运行统计

GET /stats 查看请求量、失败率、在线模型数。

06

资源

源码 · 分析 · 数据
07

薅羊毛 · 免费 AI API

全部可接 OpenAI 兼容客户端 · 额度以官方为准
注:各平台免费额度与条款会变动,接入前以官方页面为准。