MAGPIE
Magpie 一键接入 RootFlowAI
从 RootFlowAI API Key 管理页导入 Magpie，选择线路、查看可用模型，并在客户端为 Agent 配置模型。
最后验证：2026-10-27
在 RootFlowAI 的 API Key 管理页，可以将线路、API Key 和当前令牌可用的模型列表一起导入 Magpie。导入后，RootFlowAI 会作为一个供应商出现在 Magpie 中，你可以再为各个 Agent 选择模型。
一键导入
- 安装 Magpie，导入链接需要 0.1.8 或更新版本。
- 登录 RootFlowAI API Key 管理页，找到需要使用的令牌。
- 打开「导入 CC Switch \ Magpie」菜单，选择「Magpie」。手机端先打开令牌详情，再使用导入菜单。
- 选择主站、香港或美国线路，检查供应商名称及模型列表。
- 点击「打开 Magpie」。新标签页会打开 Magpie 导入页；如浏览器询问是否打开 Magpie，确认打开。
- 在 Magpie 中核对供应商信息并确认添加，然后为需要使用的 Agent 选择模型。
未安装时，导入页提供下载入口。安装后回到原页面，再点击打开 Magpie。浏览器阻止新标签页时，会在当前页打开导入页面。
导入哪些内容
| 内容 | 说明 |
|---|---|
| 供应商名称 | 默认是 RootFlowAI · 令牌名，可以修改；过长的名称可能被 Magpie 截短 |
| API Key | 使用当前令牌，点击「打开 Magpie」时才获取完整 Key |
| API 线路 | 三种协议使用同一条所选线路 |
| 模型列表 | 按令牌分组及模型限制生成，单次最多 200 个；超出时弹窗提示省略数量 |
| 站点链接 | RootFlowAI 官网和 API Key 管理页 |
同一令牌使用固定供应商 ID，重复导入时 Magpie 会提示替换已有配置。更换线路、修改模型权限或新增模型后，可再次导入更新。
导入不会自动选择各 Agent 的默认模型，也不会配置余额查询。模型列表表示令牌的可用范围，实际使用还需要模型支持所选 Agent 的协议与工具调用。图片、视频等专用模型出现在列表中，不代表可作为编程 Agent 的对话模型。
线路与协议
以主站为例，导入后的地址如下，通常无需手动修改：
| 协议 | 地址 |
|---|---|
| OpenAI Chat Completions | https://api.rootflowai.com/v1 |
| OpenAI Responses | https://api.rootflowai.com/v1 |
| Anthropic Messages | https://api.rootflowai.com |
选择香港或美国线路时，域名分别替换为 hk.rootflowai.com 或 us.rootflowai.com。Anthropic 地址使用根地址，不要重复追加 /v1。
常见问题
没有可用模型或导入被拒绝：检查令牌是否启用、是否过期、额度是否充足，以及分组和模型限制。弹窗打开后权限发生变化时，关闭并重新打开导入窗口。
导入后调用失败：确认 Magpie 中选择了正确的供应商和模型，并核对模型协议兼容性。导入只保存配置，不会发起模型调用；实际使用模型时按平台规则计费。
如何保护 Key：导入链接包含完整 Key，不要分享或截图完整地址。参数位于 URL 的 # 片段中，不随页面请求直接发送给 Magpie 网站服务器，但其导入页面会在浏览器中读取并交给客户端。建议为 Magpie 创建独立令牌，并设置合适的额度与模型限制；如链接泄露，请在账户中心删除该令牌并重新创建。