集成指南

不同客户端应该选择不同协议入口。控制台「API Keys」里的「使用密钥」弹窗会按密钥所属分组生成可复制配置；下面的集成页使用同一套配置格式，文档里用 <token> 代表你的 API Key。

​

推荐选择

​

通用信息

• 控制台 API Base URL：https://code.heihuzi.ai
• Codex CLI base_url：https://code.heihuzi.ai
• OpenAI SDK baseURL：https://code.heihuzi.ai/v1
• 认证方式：Bearer Token
• 模型列表：以 /v1/models 返回为准
• 图片能力：需要 API Key 分组开启图片生成权限
• Claude Code：需要 API Key 分组开启 Messages 调度能力

​

使用密钥弹窗

实际用户接入时，建议在控制台复制密钥自己的配置：

1. 进入「API Keys」。
2. 确认密钥已经分配分组。
3. 点击目标密钥的「使用密钥」。
4. 按客户端选择 Codex CLI、Codex CLI (WebSocket) 或 Claude Code。
5. 复制弹窗生成的配置到对应文件或终端。

文档中的 <token> 只是占位符，用户自己的弹窗会填入真实密钥。