申请到上科大无限量大模型的API了吗？
好，把他们上市！
本项目可以帮你进行模型转换，把你申请到的API接入Claude Code、CodeX等玩意，并且聚合你自己的其他校外API
⚠本项目 fork 自 SaberJack 的原始项目，但是因为两边需求和代码库差别越来越大，因此目前作为独立分支维护。主要改动：拆分重构后端代码、新增透传模式（直接对接原生 Anthropic / OpenAI Responses 上游）、补充安全配置、日志分级、性能优化与若干 bug 修复。
目前仅维护后端（
src/）。前端 GUI 与打包脚本已移除，请直接改config.json后运行proxy.py。
- 转换（网关）模式，将你的编程工具接入上科大的 LLM API，适用于上科大这种一个模型一个key的零散场景
- 透传模式，可以同步整合校外API
- 可以通过映射模型名称，自由在校内模型和你自己买的模型之间切换
- 模块化外部路由插件：把ComfyUI workflow 任务等非 LLM 能力挂到同一端口上 注意，之前学校模型的tool use似乎有点毛病，所以普通的转接用不了，现在好像又修复了，大家也可以试一下
- Python 3.10+
- 可选
orjson（pip install orjson）
把config.example.json复制到src文件夹，并改名为config.json
编辑 src/config.json
-
host：默认
127.0.0.1即可 -
port：开通访问的端口，接入时会练到这里
-
timeout：上游请求的超时时间（秒）
-
default_stream：默认开启流式输出
-
auth_key：就是你自定义下游接入所需的key。健康检查（
/、/health、/v1）不包含敏感信息，豁免鉴权，其他接口（含/v1/models）都需要 key -
log_level：日志等级，0-3分别为silent、error、info、debug
-
ssl_cert&ssl_key：用于开启SSL,填写后自动开启HTTPS访问并关闭HTTP，如果仅本地部署本地使用倒是无所谓，但是请配合下面的白名单
-
allowed_ips&denied_ips：黑白名单，黑名单高于白名单，支持单 IP 与 CIDR，如果仅本地部署使用，请在白名单里面写一个127.0.0.1（会自动开启）
-
max_request_body_bytes：单个请求体的字节上限，默认
31457280（30 MB）。内嵌图片走base64 data URL，体积很容易顶穿较小的上限；调大后热生效，不必重启。校方上游另有约 20 MB 的图片上限，超出时上游会回「非法的base64图片数据」
在example中的models字段，前两个是转换模式
-
name是你自定义的下游用来请求的名字，你可以随便起，但不能重名
-
upstream_model是向上游请求的模型名称（申请后会告诉你）
-
base_url地址都是
https://genaiapi.shanghaitech.edu.cn/api/v1/start -
api_key申请了会给你
-
api_format应该都是
chat_completions（后续不知道会不会有变化，不过申请到的ChatGPT是response，我没测试过这个玩意） -
support xxx是三个能力项，根据模型自行判断
-
max_context_tokens用于广播当前模型的参数，没啥用
-
supports_reasoning&enable_thinking基本都支持，填true即可
后两个是透传模式，会直接转发请求到目标网址，唯一的区别就是会将请求模型中的地址从name替换为upstream_model，也就是替换为你真正要请求的模型名称，不过claudecode和codex请赋予不同的名称且指向对应的真实请求地址
写完后如果程序启动不起来，就检查一下json格式有没有错
用python运行proxy.py，也可以自行打包
linux系用户可以注册为systemd，参考src/shtu-proxy.service实现自动启动
windows用户可以自己注册为服务
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /、/health、/v1 |
健康检查 |
| GET | /v1/models、/models |
可用模型列表 |
| POST | /v1/messages |
Anthropic Messages 代理入口 |
| POST | /v1/responses |
OpenAI Responses 代理入口 |
| POST | /v1/messages/count_tokens |
Token 计数 |
/responses、/compact、/cancel、/input_items 等 Codex 专有路径也一并支持，带不帶 /v1 前缀均可。
具体配置方法可以参考各模型商的官方接入方式，注意要开HTTPS你就要签证书，如果自己签证就要关掉客户端的验证或自己安装
下面一些简单说明：
- API Base URL 填
http://主机IP:port，如果开启了SSL就要改为HTTPS，默认就是 - API Key 填
config.json的auth_key为你写的那个auth_key - 其他参数自行配置
在 ~/.codex/config.toml 指向本代理，wire_api 用 responses，模型名填 config.json 里的 model_id。
然后在~/.codex/auth.json里填入key
除LLM 转发外，代理还能通过插件挂载额外的 HTTP 路由（目前内置 ComfyUI workflow 任务接口）。在 config.json 的 plugins[] 中声明即可。
部署相关的路径与上限都放在 plugins[].options 里由配置注入，插件源码不硬编码任何本机路径。
- 插件编写说明 —— 如何注册插件、Route 接口约定、路由执行顺序、内置 ComfyUI 路由一览
- ComfyUI Workflow 接口使用说明 —— workflow 模板查询、surface 编辑、提交任务、结果下载的完整操作手册
PYTHONPATH=src uv run --with pytest --python /opt/anaconda3/bin/python3 pytest -q不要提交真实 API key。src/config.json 是本机配置，已在 .gitignore 中排除；示例见 config.example.json。