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

多账号可用英文逗号分隔；并发请求会优先分配到空闲账号，避免单个 Freebuff 账号的全局 active free session 被并发切模型请求互相覆盖：

FREEBUFF_TOKEN=token-a,token-b,token-c

复制 .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
FREEBUFF_HOST=0.0.0.0
FREEBUFF_PORT=8000

默认不启用代理，所有上游请求直连，且不会读取系统 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
• minimax/minimax-m3
• google/gemini-2.5-flash-lite
• google/gemini-3.1-flash-lite-preview
• google/gemini-3.1-pro-preview
• mimo/mimo-v2.5
• mimo/mimo-v2.5-pro

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

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