API Key 管理
页面入口
API Key 管理页位于 /dashboard/api-keys。这是用户接入模型网关前最重要的页面。
Provider 选择
页面展示 OpenAI、Anthropic、Gemini、MiniMax 等 Provider。选择 Provider 后，页面会加载：
- Provider 说明。
- 支持模型。
- 可选渠道分组。
- 推荐接入目标。
- 对应 Agent 文档入口。
创建 API Key
创建流程：
- 选择 Provider。
- 等待渠道分组加载完成。
- 选择一个或多个渠道分组。
- 点击创建 API Key。
- 复制完整 API Key。
- 将 Key 保存到本地密钥管理器或环境变量中。
完整 Key 是敏感凭证。用户应避免把 Key 粘贴到公开仓库、Issue、聊天窗口或截图中。
渠道分组
渠道分组用于决定这个 Key 通过哪些通道调用。页面会显示分组名称、说明和倍率信息。
多分组能力用于提高可用性：
- 可以选择多个分组。
- 分组会形成顺序链路。
- 当前分组不可用时，可按配置切换到后续分组。
实际分组名称和倍率由系统当前可用配置决定，用户只需要按页面展示选择。
API Key 列表
Key 列表展示：
- Key 名称。
- 脱敏前缀和后四位。
- Provider。
- 分组和分组说明。
- 上游名称。
- 剩余额度和已用额度。
- 创建时间。
页面可能提供复制、编辑分组、删除等操作。
修改分组
当某个 Key 需要切换通道时，可以编辑分组。适用场景：
- 某个渠道不可用，需要切到其他渠道。
- 希望把一个 Key 从单分组调整为多分组。
- 希望按成本或稳定性调整默认通道。
修改后，使用该 Key 的客户端通常不需要更换 Key，只需要继续使用原 Key 调用。
删除 API Key
删除 Key 会使该 Key 失效。删除前应确认：
- 没有生产服务仍在使用该 Key。
- 已经为需要继续运行的服务替换新 Key。
- CI、服务器环境变量、本地配置和团队成员配置都已同步更新。
Provider 对应接入方式
- OpenAI：常用于 Codex 和 OpenAI-compatible 客户端，Base URL 通常是
https://api.token4ai.cloud/v1。 - Anthropic：常用于 Claude Code，Base URL 通常是
https://api.token4ai.cloud。 - Gemini：常用于 Gemini CLI，Base URL 通常是
https://api.token4ai.cloud。 - MiniMax：常用于 OpenAI-compatible 客户端，具体模型名以页面展示为准。
常见问题
创建失败
可能原因：
- 未登录或会话过期。
- Provider 暂无可用分组。
- 选择了无效分组。
- 当前账号或后端接口暂时不可用。
找不到完整 Key
完整 Key 应在创建后立即复制保存。如果没有保存，应重新创建一个新 Key，并删除不再使用的旧 Key。
调用失败但 Key 存在
按顺序检查：
- Base URL 是否正确。
- Provider 和客户端协议是否匹配。
- 模型名是否存在。
- 余额是否足够。
- 分组是否可用。
- 使用历史里是否有对应失败记录。