freebuff2api

Codebuff Freebuff 的 OpenAI-compatible API

接口

• GET /v1/models
• POST /v1/chat/completions
• GET /healthz

配置

获取 Token

无需安装 Freebuff / Codebuff CLI，可以直接打开公开页面自动获取 token：

https://freebuff.071129.xyz/

使用方式：

1. 打开上面的地址
2. 选择 Freebuff
3. 点击“开始认证”，在跳转页面完成授权
4. 回到页面复制展示的 token
5. 将复制结果写入本项目 .env

示例：

FREEBUFF_TOKEN=你的 Freebuff Bearer token

复制 .env.example 为 .env，然后填写上游 token：

Copy-Item .env.example .env

.env 示例：

FREEBUFF_TOKEN=你的 Freebuff Bearer token
FREEBUFF_API_KEY=本地 OpenAI API key，可留空
FREEBUFF_AD_PROVIDERS=gravity,zeroclick
FREEBUFF_PROXY_ENABLED=false
FREEBUFF_PROXY_URL=
FREEBUFF_DEBUG=false
FREEBUFF_LOG_LEVEL=INFO
FREEBUFF_LOG_BODY_CHARS=2000
FREEBUFF_LOG_COLOR=true

代理

默认不启用代理，所有上游请求直连，且不会读取系统 HTTP_PROXY / HTTPS_PROXY。

需要让所有上游请求经过代理时，在 .env 中开启：

FREEBUFF_PROXY_ENABLED=true
FREEBUFF_PROXY_URL=http://127.0.0.1:7890

支持 HTTP 和 SOCKS 代理，例如：

FREEBUFF_PROXY_URL=http://127.0.0.1:7890
FREEBUFF_PROXY_URL=socks5://127.0.0.1:1080
FREEBUFF_PROXY_URL=socks5h://127.0.0.1:1080

当前内置 Freebuff 模型：

• deepseek/deepseek-v4-flash
• deepseek/deepseek-v4-pro
• moonshotai/kimi-k2.6
• minimax/minimax-m2.7

当前内置 Gemini free agent 组合：

• google/gemini-2.5-flash-lite -> base2-free-deepseek-flash 父 agent + file-picker 子 agent
• google/gemini-3.1-flash-lite-preview -> base2-free-deepseek-flash 父 agent + file-picker-max 子 agent
• google/gemini-3.1-pro-preview -> base2-free-kimi 父 agent + thinker-with-files-gemini 子 agent

调用 Gemini 时无需手动传 agent。项目会把 OpenAI 请求中的 model 解析为上游允许的 agentId + model 组合，并继续在 codebuff_metadata.cost_mode=free 下请求。Gemini free agents 会自动作为 active Freebuff session root 的子 agent 运行；未知模型不会自动兜底到 Gemini。

调试空返回或上游异常时：

FREEBUFF_DEBUG=true
FREEBUFF_LOG_LEVEL=DEBUG
FREEBUFF_LOG_BODY_CHARS=0

运行

uv sync
uv run freebuff2api

或：

python -m pip install -e .
python main.py

调用示例

curl http://127.0.0.1:8000/v1/chat/completions `
  -H "Authorization: Bearer $env:FREEBUFF_API_KEY" `
  -H "Content-Type: application/json" `
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

流式：

curl -N http://127.0.0.1:8000/v1/chat/completions `
  -H "Authorization: Bearer $env:FREEBUFF_API_KEY" `
  -H "Content-Type: application/json" `
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [{"role": "user", "content": "写一个 Python 快排"}],
    "stream": true
  }'

感谢

FreeBuff