Z

Zen Free Gateway

检查中…

连接信息 — 给 Cursor / Cline / Claude Code 填这些

Base URL
—
API Key
你部署时设置的 ZEN_API_KEY
Model
deepseek-v4-flash-free

出口池 — 直出优先,429 自动冷却换 ProxyIP,需先填下方 API Key

zen 免费额度按出口 IP 计,所以网关要有多条出口、撞额度时能换一条。 首选 CF 边缘直出(无中继、无额外握手);它被限流时自动换成 ProxyIP —— 非 CF 机器上的 TLS 透传中继,上游看到的是中继机器的 IP,等于换了一份额度。 任意一条回 429 就冷却90 秒,期间走别的,到期再回来试。
批量新增
支持 IP:端口#地区、域名、URL，以及空白、逗号或分号分隔；自动去重。单次最多 500 条，候选地址请分批导入并实测。
域名展开
建议用「域名展开」:域名是 DNS 轮询池,直接存域名的话冷却记不到具体 IP 上,轮换会失效。
地址备注状态 成功失败操作
加载中…

在线测试 — Key 只存在浏览器本地

API Key
模型
消息
等待请求…

用量统计 — 存在 D1,按天+模型累加

总请求
0
0 成功 / 0 失败
总 Token
0
—
输入 Token
0
prompt
推理 Token
0
含在输出内
日期模型请求成功 失败输入输出 推理合计
暂无数据

与桌面版的差别 — 部署前请读

保留:OpenAI 协议兼容(/v1/chat/completions、/v1/models)、API Key 鉴权、流式透传、Token 用量统计,以及 429 自动冷却换出口(不再需要 mihomo)。
差别:桌面版换的是 mihomo 机场节点,这里换的是「CF 边缘直出 + ProxyIP 中继」。直出是首选 —— 无中继、无额外握手、延迟最低;只有它撞上 429 时才切 ProxyIP。
为什么还要 ProxyIP:免费额度按出口 IP 计,直出只有你所在 colo 那一份额度。多加几条 ProxyIP 就是多几份额度 —— 直出被限的 90 秒里仍然能用。公共 ProxyIP 是他人善意资源,稳定性无保证,生产建议自建。
全部出口都在冷却时返回 429 + Retry-After,由调用方退避重试。想彻底关掉直出(只走 ProxyIP),设环境变量 ZEN_DISABLE_DIRECT=1。
编辑 ProxyIP 池需要绑定 KV namespace(变量名 KV,无需建表);没绑 KV 时只能用环境变量 ZEN_PROXYIP 配置,且冷却状态仅在单个实例内有效。直出不受此限制,任何情况下都可用。
为什么池子用 KV、统计用 D1:KV 免费层写 1000 次/天但读 10 万次/天,池子(仅编辑时写)和冷却(仅 429 时写)正好写少读多;用量统计是每请求一写,只有 D1 扛得住。