快速开始

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，点击唯一的“使用钉钉登录”入口。登录仅允许配置企业内的钉钉身份，不提供公开注册和密码登录。

2. 创建 API Key

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

3. 查看模型

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

4. 调用 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 查看。