AI 大模型统一网关

iMatrix 接入
主流智能体指南。

一次注册,处处可用。从注册到智能体配置,三步完成。

前往 ai.imatrix.cc 开始配置 ↓
01 · BASE URL
https://ai.imatrix.cc/v1
接口地址,所有客户端统一使用。
02 · API Key
ak-xxxxxxxx
在平台生成,仅显示一次,请立即保存。
03 · 模型 ID
AiMatrix-flash / glm-5.3 …
具体以平台「模型」页为准。
第一章

平台注册与 Key 获取。

在浏览器中完成注册,创建 API Key,并收集接入三要素。后续所有智能体配置都以这三项为依据。

步骤 01

注册账号

打开 https://ai.imatrix.cc,依次填写昵称、邮箱,点击「发送验证码」并填入 6 位邮箱验证码,设置至少 6 位密码。企业/团队名称与推荐码为选填,不填则注册为个人用户。点击「创建账号」完成注册。

注册页面
步骤 02

创建 API Key

登录后进入 API Keys 页面,点击右上角「创建 API Key」:填写 Key 名称,令牌分组默认「默认组」,过期时间建议选「永不过期」,模型限制与 IP 白名单可留空。确认后点击「创建」。

创建 API Key
步骤 03

收集接入三要素

在 API Key 管理页与「API 接入指南」板块收集:BASE URL、API Key(点击复制,妥善保存)、模型 ID。这三项是后续 WorkBuddy 与 Codex 配置的通用依据。

接入三要素
第二章

WorkBuddy 自定义模型配置。

在 WorkBuddy 中将 iMatrix 添加为自定义模型,测试连通后即可在对话中随时切换。

步骤 01

进入配置入口

打开 WorkBuddy 并新建任务,点击输入框右下角的模型选择器,在弹出菜单中选择「配置自定义模型」。

配置入口
步骤 02

选择「自定义」供应商

在「设置—模型」页点击「添加模型」。供应商仅支持 OpenAI 兼容协议 API,下拉到底在「其他」分类中选择「自定义」。

选择自定义供应商
步骤 03

填写三要素并测试连接

接口地址填 https://ai.imatrix.cc/v1;API Key 填第一章生成的 Key;模型名称填 iMatrix 平台的模型 ID 或套餐 ID。填完点击「测试连接」,验证通过再继续。

填写三要素
步骤 04

高级配置与保存

按需勾选工具调用、图片输入、思考模式等能力;思考强度保持「自动」;输入/输出上下文按模型实际规格填写(示例 1000000)。确认后点击「保存」,回到任务页即可在自定义模型分组中切换使用。

高级配置
第三章

Codex 智能体 × CC Switch。

在 Codex 中使用 iMatrix 网关,需要借助 CC Switch 完成供应商配置,支持多模型自由切换。CC Switch 官网:cc-switch.cc。

步骤 01

安装 Codex

打开 CC Switch(cc-switch.cc),进入「应用」页面,在未安装列表中找到 Codex(通过 npm 安装),点击「安装」并打开右侧开关。

安装 Codex
步骤 02

添加供应商

进入左侧「Codex」页面,点击右上角「+ 添加供应商」。

添加供应商
步骤 03

选择自定义配置

在供应商列表顶部选择「自定义配置 · 手动填写所有字段」。

选择自定义配置
步骤 04

填写信息并获取模型

名称填 iMatrix(备注可填公司名);API Key 填 iMatrix 提供的 Key,下方 auth.json 会自动填充;API 请求地址填 https://ai.imatrix.cc/v1。点击「获取模型列表」拉取模型 ID,也可手动添加、可添加多个模型。设好默认模型后点击「添加」。

填写供应商信息
步骤 05

多模型配置与保存

在编辑页可为每个模型设置上下文窗口(如 1000000)与思考等级(low→ultra / minimal→ultra),并可配置子代理模型与自动审批模型。注意:修改后需重启 Codex 生效,确认后点击「保存」。

多模型配置
附

注意事项。

●Key 安全
API Key 仅在生成后可复制,请立即保存至安全位置,切勿发送到外部渠道或提交到代码仓库。
●先测试再保存
WorkBuddy 添加模型时,务必先点击「测试连接」验证连通性,再保存。
●HTTP 404 提示
CC Switch 中「取模型查询失败 HTTP 404」多为健康检查接口不兼容,手动填写模型 ID 即可,路由正常仍可使用。
●模型名称一致性
模型名称必须与 iMatrix 平台的模型 ID 或套餐 ID 完全一致(区分大小写、不能自行缩写),否则测试连接会失败或调用报错;不确定时以平台「模型」页显示的 ID 为准,直接复制粘贴。
●重启生效
CC Switch 模型列表每次修改后,均需重启 Codex 才能生效。
需要协助?
注册、接入或配置过程中遇到任何问题,欢迎联系咨询顾问,我们将在 1 个工作日内回复。
联系咨询顾问