Qoder2API 的 Go 语言实现 —— 将 Qoder AI 服务桥接为 OpenAI 兼容 API。
本项目参考 fengyinxia/qoder2api: QoderWork -> OpenAI compatible API bridge (dynamic model loading, pure Python) ，将原有 Python 代码完整重写为 Go，保留了全部核心功能，同时提升了性能与部署便利性。
- OpenAI API 兼容 —— 支持
/v1/chat/completions和/v1/models端点，可无缝替换 OpenAI API - 流式响应 —— 支持 SSE 流式输出，末尾附带 usage 帧（含输入 / 输出 / 缓存命中 / 思考 token 与实际扣费额度，遵循
stream_options.include_usage终帧格式） - 真实用量统计 ——
/v1/chat/completions响应携带网关真实 token 用量：usage.prompt_tokens/completion_tokens/total_tokens、prompt_tokens_details.cached_tokens、completion_tokens_details.reasoning_tokens，以及 Qoder 扩展字段credits（实际扣费额度）/original_credits（折扣前额度） - 多模态支持 —— 支持图片输入
- Tool Calls —— 支持函数调用
- 模型动态加载 —— 自动从网关获取可用模型列表
- Web 管理面板 —— 浅色排版风格中文界面（支持深浅模式），支持密码登录、API 密钥管理、PAT 配置、模型查看、请求统计（总量 / 成功失败 / 总输入 / 总输出 / 缓存命中 / 本周期扣费额度与重置倒计时 / 按模型 / 近 24 小时趋势）
- 订阅周期感知 —— 从网关
/algo/api/v3/user/status读取真实订阅信息（套餐、组织、nextResetAt重置时间、isQuotaExceeded超额标记），使面板额度按计费周期统计而非终身累计 - 单文件部署 —— 编译为单一二进制文件，零外部依赖
| 显示名称 | 内部 Key |
|---|---|
| Qwen3.8-Max | qmodel_38max |
| Qwen3.7-Max | qmodel_latest |
| Qwen3.7-Plus | qmodel |
| Qwen3.6-Flash | q36fmodel |
| DeepSeek-V4-Pro | dmodel |
| DeepSeek-V4-Flash | dfmodel |
| GLM-5.3 | gmodel |
| GLM-5.2 | gm51model |
| Kimi-K2.7-Code | kmodel |
| MiniMax-M2.7 | mmodel |
以上为内置默认列表（catalog-v6，2026-08-15），实际可用模型以网关动态返回为准。
关于图片输入：部分模型并非原生多模态，而是由网关对图片附带辅助识别（非原生多模态模型加上辅助后实际可以识图），因此上表不再标注是否支持视觉；识图效果以实际调用结果为准。
# 编译
go build -o qoder2api .
# 运行（默认监听 0.0.0.0:10081）
./qoder2api收到
SIGINT（Ctrl+C）或SIGTERM会触发优雅关闭：停止接受新连接、等待在途请求并落盘统计后退出。
# 使用 docker-compose
docker-compose up -d
# 或手动构建
docker build -t qoder2api .
docker run -d -p 10081:10081 -v qoder2api-data:/app/data -e QODER_DATA_PATH=/app/data/data.json qoder2api前往 Releases 下载对应平台的二进制文件，直接运行即可。
| 变量名 | 默认值 | 说明 |
|---|---|---|
QODER_HOST |
0.0.0.0 |
监听地址 |
QODER_PORT |
10081 |
监听端口 |
QODER_DATA_PATH |
data.json |
数据文件路径 |
QODER_ADMIN_PASSWORD |
password |
管理面板密码（覆盖 data.json 中的值） |
QODER_SIGNATURE_SECRET |
内置值 | 请求签名密钥 |
QODER_CHAT_TIMEOUT_SECONDS |
120 |
Chat 响应超时：等待上游开始响应（返回响应头）的最长秒数，范围 1-3600；设置后管理面板中不可修改 |
QODER_IDLE_TIMEOUT_SECONDS |
300 |
流空闲超时：流式响应中持续无数据的最长等待秒数，范围 1-3600（数据持续到达时流不会被中断）；设置后管理面板中不可修改 |
QODER_MAX_CONCURRENCY |
1 |
单 PAT 同时发往上游的聊天请求数上限；超出部分本地排队等待。调大会提升吞吐，但超过 Qoder 账号的并发窗口时网关会拒绝请求（业务码 10605） |
两个超时也可在管理面板「设置 → 超时配置」中修改，保存后即时生效（无需重启）。响应超时只约束上游「开始响应」，不会截断已经建立的流。
请求统计（
stats字段）随 data.json 持久化：服务每 30 秒批量写入一次，并在收到SIGINT/SIGTERM优雅关闭时执行最终落盘；仅统计通过密钥鉴权且请求体合法的调用，客户端主动断开不计入失败。令牌用量（总输入 / 总输出 / 缓存命中 / 实际扣费额度）从网关 usage 帧自动累计，流中断无 usage 帧时仅计次不计量。
首次运行时自动生成，也可通过 Web 管理面板修改：
{
"host": "0.0.0.0",
"port": 10081,
"pat": "pt-xxxxxxxx",
"password": "password",
"chat_timeout_seconds": 120,
"idle_timeout_seconds": 300,
"api_keys": [
{
"id": "xxxxxxxx",
"key": "sk-xxxxxxxxxxxxxxxx",
"note": "备注",
"created_at": 1234567890
}
]
}GET /health 返回服务状态（免鉴权，供容器探针 / 负载均衡使用）：
{
"status": "ok",
"has_pat": true,
"chat_timeout_seconds": 120,
"idle_timeout_seconds": 300
}启动服务后访问 http://localhost:10081/admin，输入默认密码 password 登录，在「令牌」标签页中填入你的 Qoder PAT。
⚠️ 默认密码仅用于首次登录，请立即在「设置」标签页中修改。登录失败会按客户端 IP 触发指数退避限流，部署到公网时务必启用 HTTPS 反代。
在「API 密钥」标签页中创建密钥（可自定义或自动生成），客户端使用此密钥调用 API。
curl http://localhost:10081/v1/chat/completions \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen3.7-Max",
"messages": [{"role": "user", "content": "你好"}],
"stream": true
}'curl http://localhost:10081/v1/models \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"请求体支持 OpenAI 风格的 reasoning_effort。有效档位写入网关请求的 parameters 对象（与官方客户端一致），无需额外的 device token、Bearer token 或模型服务域名配置；未携带该字段的请求保持原有行为。
{
"model": "Qwen3.8-Max",
"messages": [{"role": "user", "content": "你好"}],
"reasoning_effort": "xhigh"
}桥接层从动态模型目录读取每个模型的 efforts 与 supports_disabled 后校验档位：有效值为 none、low、medium、high、xhigh、max，minimal 会映射为 low。不受当前模型支持的档位会被省略，模型继续使用默认思考强度；不会发送可能导致上游拒绝的无效值。
注意：档位必须放在
parameters内才会生效。网关不读取请求体顶层的reasoning_effort，写在该位置会被静默忽略，模型一律按默认强度思考。此外parameters还承载max_tokens、tool_choice等字段，桥接层会自动组装，调用方无需关心。
none 是二值开关而非强度档位，需要额外配合才能真正关闭思考。桥接层在档位解析为 none 时会同时做三件事（与官方客户端行为一致）：
parameters.reasoning_effort置为"none"parameters.max_thinking_tokens显式置为0（该字段用指针承载，以保证0不被 JSON 序列化省略）model_config.is_reasoning与chat_context.extra.modelConfig.is_reasoning均置为false
其余档位不会写入 max_thinking_tokens：官方客户端仅在技能 / 子代理覆盖场景才把档位换算为思考预算，主交互路径只发送档位字符串。
两项能力信息来自网关模型目录，与官方客户端的解析方式一致：
is_reasoning：取目录的is_reasoning字段，缺失时为false。动态目录不可用时回退为true，以保持桥接层原有的"默认开启思考"行为，避免静默关闭所有模型的思考能力。max_tokens：取目录的max_output_tokens，缺失或非法（非正整数）时回退为32000，与官方客户端的LS()归一化结果相同。
pi 客户端配置示例：Qoder 上游不接受 OpenAI 的 developer 角色，而 pi 会用该角色承载代理指令；因此必须在 ~/.pi/agent/models.json 的 qoder-local provider 上设置 supportsDeveloperRole: false，使 pi 改用 system 角色。为模型设置 reasoning: true，并将 pi 的档位映射到模型目录实际支持的值：
{
"providers": {
"qoder-local": {
"compat": {
"supportsDeveloperRole": false
}
}
}
}以下模型配置适用于支持 low / medium / xhigh 的模型（max 映射到目录实际支持的最高档位，避免发送被上游丢弃的无效值）：
{
"id": "Qwen3.8-Max",
"reasoning": true,
"thinkingLevelMap": {
"off": "none",
"minimal": "low",
"low": "low",
"medium": "medium",
"high": "xhigh",
"xhigh": "xhigh",
"max": "xhigh"
}
}| 端点 | 方法 | 说明 |
|---|---|---|
/v1/chat/completions |
POST | 聊天补全（兼容 OpenAI 格式） |
/v1/models |
GET | 获取模型列表 |
/admin |
GET | Web 管理面板 |
/admin/api/login |
POST | 管理面板登录 |
/admin/api/keys |
GET/POST/DELETE | API 密钥管理 |
/admin/api/pat |
GET/POST | PAT 令牌管理 |
/admin/api/models |
GET | 获取模型列表 |
/admin/api/stats |
GET | 请求统计（总量 / 按模型 / 近 24 小时趋势 / token 用量 / 扣费额度 / 计费周期与套餐信息） |
/admin/api/config |
GET/POST | 服务器配置 |
/admin/api/password |
POST | 修改管理密码 |
错误响应约定：登录失败限流返回 429（附 Retry-After）；创建重复 API Key 返回 409；端口配置越界（非 1–65535）返回 400；未鉴权或会话过期返回 401。
管理面板使用 Qoder 官方客户端同源的额度接口，展示当前计费周期的权威用量，而不是仅统计本服务启动后的局部消耗：
套餐额度 2,939 / 3,000 剩余 61 可用
加购额度 0 / 1,000 剩余 1,000 可用
组织资源包 120 / 4,000 剩余 3,880 可用
合计剩余 4,941 · 09-25 重置
主数据来自 GET https://openapi.qoder.com.cn/api/v2/quota/usage，使用现有 jobToken 交换返回的 securityOauthToken 作为 Bearer。该接口与官方客户端 /usage 面板相同，提供：
| 字段 | 含义 | 用途 |
|---|---|---|
userQuota.total/used/remaining |
套餐总额、已用及剩余 Credits | 面板主要额度数字 |
userQuota.percentage |
套餐使用比例 | 管理 API 输出及详细信息 |
addOnQuota |
加购额度包（存在时） | 管理 API 输出及额度明细卡 |
orgResourcePackage |
组织资源包容量、已用、剩余及可用状态 | 管理 API 输出及额度明细卡 |
expiresAt |
当前额度周期结束时刻 | 重置日期与倒计时 |
isQuotaExceeded |
官方客户端采用的超额判定 | 面板红色告警徽标 |
网关 POST /algo/api/v3/user/status?Encode=1 仍负责提供 plan、userTag、组织名称和真实 userType。它的 quota: 0 是精简字段，不能解释为套餐没有数字上限；额度必须以 OpenAPI 的 userQuota 为准。
- 官方额度优先：面板的套餐用量来自账号级 OpenAPI，包含 IDE、CLI 和本服务产生的全部消耗，也能覆盖服务启动前的当期用量。
- 额度来源分别展示：套餐额度、加购额度和组织资源包在额度明细卡中分别成行展示，并汇总各额度来源返回的剩余 Credits；组织资源包的“可用/不可用”状态以 OpenAPI 返回值为准。
- 本地累计仅作降级：usage 帧中
billable=false的请求仍计入 token，但不计入本地 credits；OpenAPI 从未成功时，面板才显示本服务观察到的周期消耗，并明确标注口径。 - 周期边界权威同步：优先使用 OpenAPI
expiresAt；本地周期起点按自然月回退推导，断网期间仍可完成一次性滚动。 - 累计值仍保留：
stats.credits保存本服务历史累计扣费，鼠标悬停在额度行可查看。
主程序启动后立即获取一次额度，此后每分钟在后台刷新。管理面板的 15 秒轮询完全读取内存和持久化快照，不直接调用上游；临时网络故障会保留最后一次成功结果。
jobToken 响应中不含 userType 字段，此前 bridge 一律回退为 personal_standard，导致团队账号的签名会话载荷层级错误。现改为在构建会话之前从 /user/status 取真实层级（该值被 AES 签入 bearer 载荷，事后无法修改）。状态接口临时不可用时，按「上次已知层级 → 空值 → 历史默认值」顺序降级，避免续期时把团队账号静默降级。
本项目面向内网 / 个人使用，已内置以下加固措施，部署到公网前请务必修改默认密码并使用 HTTPS 反代：
- HTTP 超时：
ReadHeaderTimeout=10s、IdleTimeout=120s，抵御 slowloris 类慢速连接耗尽；WriteTimeout不设以兼容长连接 SSE 流式响应，流内超过 5 分钟无数据（空闲）自动断开，防止网关连接卡死。 - 请求体上限：
/v1/chat/completions限制 10 MiB，管理 API 限制 64 KiB，防止超大 payload 耗尽内存。 - 登录限流：管理面板登录按客户端 IP 计数，失败后指数退避（1s → 30s 封顶），锁定期间返回
429+Retry-After。 - 恒定时间比较：API Key 校验与管理密码比对均使用
crypto/subtle，避免时序侧信道泄露。 - Cookie 安全：会话 Cookie 为
HttpOnly+SameSite=Lax，在 HTTPS（含X-Forwarded-Proto: https反代）下自动附加Secure。 - 优雅关闭：收到
SIGINT/SIGTERM后停止接受新连接、等待在途请求（最长 15s）并完成统计最终落盘，避免数据丢失。 - XSS 防护：Web 面板用户输入通过
textContent渲染与addEventListener绑定，避免内联事件处理器中的字符串注入。 - 输入校验：API Key 唯一性校验（重复返回
409）；端口范围校验 1–65535；工具调用索引边界保护（防 panic / OOM）。
Qoder-2API-Go/
├── main.go # 程序入口（请求模板内联在 bridge 包中）
├── auth/ # 认证模块
├── bridge/ # API 桥接模块
├── models/ # 模型管理
├── store/ # 数据持久化
├── transform/ # 数据转换
├── admin/ # Web 管理面板
├── Dockerfile # Docker 构建文件
├── docker-compose.yaml # Docker Compose 配置
└── .github/workflows/ # GitHub Actions 自动构建
- 语言：Go 1.22+
- 依赖：仅使用
github.com/google/uuid，其余全部标准库 - 加密：RSA + AES 混合加密、MD5 签名、自定义 Base64 编码
- HTTP：标准库
net/http，SSE 流式响应，优雅关闭 - 存储：JSON 文件持久化，线程安全读写
- 安全：请求体上限、登录限流、恒定时间鉴权、Secure Cookie、XSS 防护
# 克隆仓库
git clone https://github.com/EchoPing07/Qoder-2API-Go.git
cd Qoder-2API-Go
# 运行测试
go test ./...
# 构建
go build -o qoder2api .
# 构建（跨平台）
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o qoder2api-linux-arm64 .本项目基于 MIT License 开源。
本项目仅供学习和研究目的使用。
- 本项目不隶属于 Qoder 或其关联公司，Qoder 是其各自所有者的商标。本项目不对任何官方服务提供保证或支持。
- 仅供学习交流使用，不得用于任何商业用途或非法用途。使用者应遵守所在地区的法律法规。
- 本项目不对任何因使用或滥用本项目而导致的直接或间接损失负责，包括但不限于数据丢失、服务中断、账号封禁等情况。
- 使用者需自行承担使用本项目的所有风险，项目维护者不对本项目的正确性、完整性、可靠性或适用性作任何明示或暗示的保证。
- 请勿将本项目用于绕付费、绕限制、大规模爬取或其他可能损害服务提供方利益的行为。请尊重服务提供方的条款和条件。
- 如果本项目的任何内容侵犯了您的权益，请及时联系项目维护者，我们将积极配合处理。
使用本项目即表示您已阅读并同意以上免责声明。如果您不同意，请立即停止使用并删除本项目。