GodeX 让使用 OpenAI Responses API 的客户端,可以通过一个本地网关调用 DeepSeek、Xiaomi、MiniMax、智谱等只提供 Chat Completions API 的模型提供商。
GodeX 1.0.0 发布,面向 Codex 的 Responses API 兼容网关
GodeX 是一个 OpenAI Responses API 兼容网关,让 Codex、CLI 工具和开发者 Agent 通过本地服务接入 DeepSeek、Xiaomi、MiniMax、Zhipu 等 Chat Completions provider。
GodeX 1.0.0 已发布。
GodeX 是一个 OpenAI Responses API 兼容网关,主要面向 Codex、CLI 工具和开发者 Agent。它提供本地 /v1/responses 服务,把客户端的 Responses API 请求桥接到上游 Chat Completions provider,再把结果重建为 Responses API 输出。
项目目标是解决一个实际问题:很多模型 provider 提供 Chat Completions 接口,但 Codex 等工具使用 Responses API。GodeX 在中间提供一层本地协议网关,让客户端保持统一协议,provider 差异由网关集中处理。
Responses API Codex Provider Bridge TypeScript + Bun
项目特性
- OpenAI 兼容的
POST /v1/responses,支持同步和流式响应。
GET /v1/models 暴露模型别名,让客户端使用稳定模型名。
- 内置 DeepSeek、Xiaomi、MiniMax、Zhipu provider。
- 支持 provider capability 规划:工具调用、
tool_choice、结构化输出、reasoning、stream usage。
- 支持
previous_response_id 会话链,可使用 memory 或 SQLite。
- 默认开启 SQLite trace,记录 provider request、response、stream event、usage 和 error。
- 基于 Bun + TypeScript,提供 npm 安装和 Docker 镜像。
架构
GodeX 的核心设计是 bridge kernel + ProviderSpec:
bridge 负责公共 Responses-to-Chat 策略,包括请求归一化、兼容性规划、工具规划、结构化输出、响应重建和流式状态机。
providers 负责 provider-specific 能力声明、endpoint、auth、hooks 和协议 DTO。
responses 负责编排同步和流式 pipeline。
trace 记录请求链路,方便调试 Agent 执行过程。
Provider hooks 只表达协议差异,公共兼容策略由 bridge kernel 统一决策,避免每个 provider 重复实现一套 adapter。
内置 Provider
| Provider |
Default Model |
Reasoning |
Tool Choice |
Response Format |
Cached Tokens |
| DeepSeek |
deepseek-v4-pro |
native |
auto, none, required, function |
text, json_object |
支持 |
| Xiaomi |
mimo-v2.5-pro |
boolean |
auto |
text, json_object |
支持 |
| MiniMax |
MiniMax-M2.7 |
none |
auto, none, required, function |
text, json_object |
支持 |
| Zhipu |
glm-5.1 |
boolean |
auto, none |
text, json_object |
支持 |
快速开始
npm 安装
npm install -g @ahoo-wang/godex
godex init
godex serve --config ./godex.yaml
Docker
docker pull ahoowang/godex:latest
docker run -d \
--name godex \
-p 5678:5678 \
-e ZHIPU_API_KEY=your-key \
-e DEEPSEEK_API_KEY=your-key \
-e MINIMAX_API_KEY=your-key \
-e MIMO_API_KEY=your-key \
-v ./godex.yaml:/etc/godex/godex.yaml:ro \
-v godex-data:/data \
ahoowang/godex:latest
Codex 集成
在 ~/.codex/config.toml 中添加:
model = "gpt-5.5"
model_provider = "godex"
[model_providers.godex]
name = "GodeX"
base_url = "http://127.0.0.1:5678/v1"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
模型别名由 godex.yaml 配置。例如:
models:
aliases:
gpt-5.5: "deepseek/deepseek-v4-pro"
gpt-5.4-mini: "zhipu/glm-5.1"
开源地址