Skip to content

OpenTrans把多家 LLM 协议统一成一套稳定的中间结构

用 Go 构建请求体、响应体与流式事件的跨协议转换层,覆盖 OpenAI Chat、OpenAI Responses、Claude 与 Gemini。

OpenTrans

为什么用 OpenTrans

当你要在 OpenAI、Claude、Gemini、Responses 之间做兼容层时,真正麻烦的通常不是某一个字段,而是整条链路都得统一。OpenTrans 把不同协议先归一化,再重新编码,让“协议切换”从一次性脚本变成可维护的工程能力。

给 API 网关用

把进入网关的请求统一转换,再按目标供应商重新输出,减少每条路由单独维护的映射逻辑。

给兼容层用

保留各家协议的典型输入输出形式,同时对外暴露稳定的标准化结构,方便做二次封装。

给观测与审计用

在中间结构层做日志、缓存、审核和回放,比在每家 provider 原始协议上逐个处理更稳。

转换路径

text
source body -> 标准化结构 -> target body
source struct -> 标准化结构 -> target struct/body
source SSE  -> 标准化事件 -> target SSE

当前推荐入口

  • SDK 调用:直接使用模块根路径 github.com/xy200303/OpenTrans
  • Web 服务:启动 go run ./services/opentransd/cmd/opentransd,默认监听 :8080
  • Docker 部署:使用 services/opentransd/Dockerfiledocker compose -f services/opentransd/docker-compose.yml up --build
  • 官网发布:进入 website/ 后执行 npm run build 构建静态站点

下一步

OpenTrans documentation site powered by VitePress