FreeTier 2API Plugin

将多个免费额度 AI 供应商接入 CLIProxyAPI 的原生动态库插件，直接复用宿主的 OpenAI / Anthropic / Responses 兼容路由、鉴权、代理与负载均衡。

中文 | English

如果这个项目帮到了你，欢迎点个 Star 支持一下。

⚠️ 重要合规提示：本项目仅限个人学习与技术研究使用，严禁用于任何商业售卖、API 转售、代充代刷、公开/收费共享池或任何违反各上游平台服务条款与法律法规的用途。单个供应商硬性限制最多添加 10 个账号。继续使用即表示您已阅读并同意文末免责声明。

• 复用宿主 Anthropic /v1/messages、OpenAI /v1/chat/completions 与 OpenAI /v1/responses 接口，无需额外部署独立网关
• 支持 8 大体系共 16 个国内外免费额度供应商实例（AutoClaw 国内/国际与小浣熊已接入），凭证严格按供应商隔离（单供应商上限 10 个账号）
• 模型清单动态探测、自定义模型别名与跨供应商同名模型自动负载均衡/故障转移
• 内嵌单页 Web 控制台：支持 OAuth 设备授权 / 本地回调粘贴 / API Key 添加账号、额度可视化、模型启停与运行日志
• 支持每日自动签到、每日自动任务与 Token 自动续期保活
• 纯 Go 标准库实现，零第三方运行时依赖

新供应商：autoclawcn / autoclawglobal（AutoClaw 国内版/国际版）与 raccoon（小浣熊）。AutoClaw 国内版支持控制台手机验证码登录、国际版支持 Zai / Google OAuth 网页登录（控制台页面内完成阿里云人机验证，登录后粘贴 localhost 回调链接；也可直接粘贴 accessToken/refreshToken JSON）；小浣熊支持控制台网页授权登录（官方授权页 + 回调链接粘贴）。协议细节与配置项见 docs/vendor-autoclaw-raccoon.md。

本插件已收录至 CLIProxyAPI 官方插件源：

1. 打开 CLIProxyAPI 管理面板 → 插件商店。
2. 搜索 FreeTier 2API 并点击一键安装。

从 Releases 下载对应平台的归档包，解压后将动态库（freetier2api.so / freetier2api.dylib / freetier2api.dll）放入 CPA 插件目录，并在 config.yaml 中启用：

plugins:
  enabled: true
  dir: "/path/to/cpa/plugins"
  configs:
    freetier2api:
      enabled: true
      enabled_realms: "cn,global"

需 Go 1.22+ 与 C 编译器（启用 CGO_ENABLED=1），或直接使用仓库内置的 Docker 构建脚本（基于 golang:1.24 Debian glibc 镜像）：

git clone https://github.com/jiandanc/CLIProxyAPI-freetier2api-plugin.git
cd CLIProxyAPI-freetier2api-plugin
./scripts/build.sh

编译产物输出至 dist/freetier2api.<so|dylib|dll>。

启动 CLIProxyAPI 后，访问内嵌控制台页面：

http://<CPA地址>:8317/v0/resource/plugins/freetier2api/console

• 点击 「添加账号 ▾」 选择对应供应商，按提示在浏览器完成 OAuth 授权或填入 API Key（每个供应商最多可添加 10 个账号）。
• 若在远程服务器 / Docker / WSL 部署，使用 Trae 或 CodeArts 登录时浏览器停留在 127.0.0.1 回调页，展开登录框下方的 「回调没到插件？粘贴回调链接」，将完整回调 URL 粘贴提交即可。

账号添加后即可通过 CLIProxyAPI 标准接口调用（支持裸模型名或 <vendor>:<model> 前缀指定供应商）：

# OpenAI Chat Completions
curl http://localhost:8317/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <CPA_API_KEY>" \
  -d '{"model":"GLM-5.3","messages":[{"role":"user","content":"你好！"}]}'

# Anthropic Messages
curl http://localhost:8317/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: <CPA_API_KEY>" \
  -d '{"model":"GLM-5.3-Flash","max_tokens":1024,"messages":[{"role":"user","content":"你好！"}]}'

在控制台「模型」表格中点击 「模型 ID」 列的名称或 ✎ 图标即可设置对外模型别名。将不同供应商的模型设为同一别名（例如把多家供应商的旗舰模型统一设为 coding-max），宿主会自动合并并在多个供应商间负载均衡与故障转移。

在宿主 config.yaml 的 plugins.configs.freetier2api 下可配置以下常用项（大多数运行期设置可直接在控制台页面调整并即时生效）：

本项目的宿主契约、部分供应商协议研究与模型元数据参考或衍生自以下开源项目，特此致谢：

• router-for-me/CLIProxyAPI（MIT）：宿主插件 ABI/API 契约（cpasdk/）与 HTTP/SSE 桥接设计。
• Sliverkiss/workbuddy2api 与 linguo2625469/workbuddy2api-panel（MIT）：WorkBuddy 协议适配、提示词过滤与日常任务体系参考。
• aimod-cc/Agent2API：AutoClaw 与小浣熊协议适配（头集合/签名、proxy 通道、授权登录、模型目录、积分与签到口径）参考。

欢迎友好交流。遇到问题时，建议先让 Claude Code、Codex 等工具帮忙排查一下，大部分问题都能自己解决。如果能直接提个 PR 就更好了。

1. 仅限个人学习与研究：本项目仅用于个人学习、技术交流与协议互操作性研究，严禁将本项目（或其编译产物、衍生服务）用于任何形式的商业售卖、API 转售、有偿代搭、代刷代充、公开算力池分发或任何非法用途。
2. 无官方关联：本项目为独立开源项目，与腾讯（WorkBuddy / CodeBuddy）、阿里（Qoder）、智谱 / Z.AI（ZCode、AutoClaw）、字节跳动（Trae）、华为云（CodeArts）、MiniMax、商汤（小浣熊）、Cline、OpenCode 等任何上游厂商均无任何隶属、合作或背书关系。
3. 合规与风险自负：通过非官方客户端调用接口、执行自动签到或自动任务可能违反各上游平台的用户服务协议（ToS），并可能导致账号受限、积分清零、封禁或其他法律与合规风险。使用者必须在合法合规及个人自用范围内使用本项目，因使用或滥用本项目产生的一切直接或间接后果均由使用者本人承担，项目作者及贡献者不承担任何责任。
4. 权利人联系：如任何上游平台或权利人认为本项目中的部分实现影响了您的合法权益，请通过 Issue 联系作者，我们将在核实后第一时间移除相关供应商适配代码。

MIT