快速开始

Meiyi AI Hub 是公司内部统一的大模型 API 网关。首期启用 Codex Responses API。

0. 首次启动配置

首次启动前必须配置以下环境变量：

export DINGTALK_CLIENT_ID="your-client-id"
export DINGTALK_CLIENT_SECRET="your-client-secret"
export DINGTALK_CORP_ID="your-corp-id"
export DINGTALK_REDIRECT_URL="http://localhost:8100/auth/dingtalk/callback"
export DINGTALK_ADMIN_UNION_IDS="first-admin-union-id"

DINGTALK_ADMIN_UNION_IDS 可用逗号分隔多个钉钉 unionId。allowlist 只负责首次管理员引导：匹配用户登录时会成为管理员，移出列表不会自动撤销数据库中已有的管理员权限。YAML 部署也可使用 dingtalk.admin_union_ids。

启动服务并让 allowlist 中的管理员完成钉钉登录后，进入 /admin 的端点管理，配置并启用 Codex/Responses 上游端点；随后在模型中心确认 gpt-5.3-codex 已绑定该端点并处于启用状态。未完成上游端点配置前，Responses API 不可用。

1. 登录

打开 /login。有公司钉钉身份的人扫码登录，仅允许配置企业内的钉钉账号。

没有公司钉钉身份的人（外包、顾问、跨公司协作）由管理员在 /admin 的用户页「新建用户」建号并下发初始密码，然后在登录页用邮箱 + 密码登录，登录后可在 /account 自行修改密码。系统不提供公开注册，账号只有这两个来源。

2. 创建 API Key

进入 /settings 创建 API Key。明文只展示一次，请立即保存到安全的密钥管理工具中。Key 泄漏后可在该页面重新生成，使旧值立即失效。

3. 查看模型

首页展示当前所有已启用的全局模型。活跃用户无需额外授权即可使用这些模型。

4. 配置 Codex

推荐从工作台进入配置 Codex，按步骤安装 Magpie、创建 API Key 并导入 Meiyi AI Hub，再为 Codex 选择模型。使用期间保持 Magpie 运行。详见 Codex 接入说明。

5. 调用 Codex Responses API

curl "$AI_HUB_BASE_URL/v1/responses" \
  -H "Authorization: Bearer $AI_HUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.3-codex","input":"Hello"}'

请求受用户和 API Key 的 RPM、最大并发限制约束。请求日志和 token 用量可在 /usage 查看。