在 Kilo Code 中接入 MiniMax从 API Key 申请到模型配置与用量解析【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocodeMiniMax 是一家专注于快速、低成本多模态模型的全球 AI 基础模型公司其旗舰模型具备较强的代码生成、工具调用与 Agent 能力。本文以仓库内官方指南 packages/kilo-docs/pages/ai-providers/minimax.md 为骨架完整讲解如何在 Kilo Code 中获取 MiniMax API Key、通过 VSCode 图形界面或 CLI 配置文件接入 MiniMax并结合仓库源码packages/core/src/kilocode/provider-usage/minimax/剖析 Kilo Code 底层如何查询与归一化 MiniMax 用量数据。读完本文你将能够在 VSCode 与 CLI 两种环境下独立完成 MiniMax 的接入与默认模型切换并理解其配额/用量展示的内部实现机制。MiniMax 与 Kilo Code 的集成概览MiniMax 是面向全球的 AI 基础模型公司主打快速、成本高效的多模态模型在代码能力、工具调用tool-use与 Agentic 能力上表现突出。其旗舰模型 MiniMax M2.1 提供高速推理与超长上下文支持适合大型代码库与 Agent 工作流场景。在 Kilo Code 中MiniMax 作为受支持的自定义/第三方提供商出现用户只需完成两件事即可开始使用在 MiniMax 平台申请 API Key在 Kilo Code 中将该 Key 配置到minimax提供商下并设置默认模型如minimax/MiniMax-M1。获取 MiniMax API Key申请 Key 的完整步骤如下与官方指南 minimax.md 一致注册/登录访问 MiniMax 控制台的访问管理页面Console Access 页面创建账号或直接登录。进入 API Keys 页面在个人资料Profile下找到API Keys入口。创建 Key点击生成新的 API Key并为其指定一个描述性名称例如Kilo Code便于日后在多个应用中区分。立即复制并妥善保存Key 只展示一次离开页面后可能无法再次查看务必第一时间复制并存入密码管理器等安全位置。注意MiniMax 提供国际站与国内站两套平台。从仓库源码 usage.ts 可以看到Kilo Code 为两种区域分别维护了不同的用量查询端点与管理页面 URL全球区域使用api.minimax.io与platform.minimax.io中国区域使用api.minimaxi.com与platform.minimaxi.com。申请 Key 时请确认自己所在的平台与区域。在 Kilo Code 中配置 MiniMaxKilo Code 提供两种等价的配置入口VSCode 图形界面与 CLI 配置文件。两者最终都写入同一个kilo.json配置文件只是编辑方式不同。方式一VSCode 图形界面在 VSCode 中打开设置齿轮图标切换到Providers标签页找到 MiniMax 并填入你的 API Key 即可。扩展会自动将配置持久化到kilo.json文件中如果你更习惯手写配置也可以直接编辑该文件格式见下方 CLI 部分。方式二CLI 环境变量或 kilo.json在 CLI 场景下有两种写法任选其一通过环境变量注入export MINIMAX_API_KEYyour-api-key通过配置文件声明推荐可持久化配置文件路径为~/.config/kilo/kilo.json全局或./kilo.json项目级{ provider: { minimax: { env: [MINIMAX_API_KEY], }, }, }这里的env: [MINIMAX_API_KEY]表示Kilo 在启动时会从名为MINIMAX_API_KEY的环境变量中读取该提供商的凭据。这样既可以把密钥隔离在环境变量中又能在配置层面显式声明依赖。设置默认模型接入完成后把默认模型切换到 MiniMax{ model: minimax/MiniMax-M1, }模型 ID 采用提供商/模型名的命名形式。此后新建会话默认使用该模型也可以在会话中临时切换。使用建议与注意事项官方指南在 Tips and Notes 一节给出的关键信息如下性能MiniMax M2.1 强调快速推理、较强的代码能力以及出色的工具调用tool-calling表现适合需要频繁调用工具的 Agent 工作流。上下文窗口MiniMax 模型支持超长上下文窗口适合处理大型代码库与长时间运行的 Agent 任务。定价定价随模型而异大致为输入每百万 token 0.20–0.30 美元、输出每百万 token 1.10–2.20 美元。价格会变动请以 MiniMax 官方文档的最新定价为准。源码级解析Kilo Code 如何查询 MiniMax 用量除接入配置外Kilo Code 还内置了 MiniMax 用量Token Plan 配额查询能力相关实现位于packages/core/src/kilocode/provider-usage/minimax/目录并注册进统一的提供商用量适配器注册表 provider-usage.ts。区域绑定与端点usage.ts 中定义了两种区域绑定providerIDregion用量查询端点套餐管理页minimax-coding-planglobal国际https://api.minimax.io/v1/token_plan/remainsplatform.minimax.io/subscribe/token-planminimax-cn-coding-planchina中国https://api.minimaxi.com/v1/token_plan/remainsplatform.minimaxi.com/subscribe/token-plan从源码结构可以推断同一账号在不同区域可能有独立套餐因此 Kilo Code 将每个区域视为独立计划即使多个 provider 共享同一凭据也会为每个区域保留独立的缓存单元缓存键形如minimax-direct-${region}。凭据识别与缓存隔离在direct()函数usage.ts中可以看到两个关键细节只有以sk-cp开头的 API Key 才会触发用量查询candidate.key.startsWith(sk-cp)普通 Key 不参与 Token Plan 用量展示Kilo Code 会对 Key 做 SHA-256 指纹createHash(sha256).update(candidate.key)作为缓存身份标识确保更换 Key 后不会通过 TTL 或过期回退误用上一个账号的配额数据。用量响应 Schema 与归一化MiniMax 用量接口的响应结构在 native.ts 中用 Effect Schema 定义顶层包含base_resp含status_code与model_remains数组每个模型条目包含区间interval与周weekly两套字段如current_interval_remaining_percent、current_weekly_usage_count、start_time/end_time、remains_time、interval_boost_permille等。usage.ts 的normalize()函数将这些原始字段转换为 Kilo Code 统一的用量快照UsageSnapshot过滤掉video模型只展示文本/代码相关模型的配额每个模型生成 interval 与 weekly 两个用量窗口UsageWindow以*_status标志为准判定窗口状态status 3表示不在套餐内status 2表示配额已耗尽源码注释还纠正了一个易混淆点MiniMax 的*_usage_count字段实际返回的是剩余配额而非已消耗数量归一化时会据此反向计算used当存在 boost加速包时interval_boost_permille/weekly_boost_permille百分比配额会按千分比系数放大为「标准单位」计。此外查询过程带有 5 秒超时AbortSignal.timeout(timeout)与 64 KB 响应体上限保护网络失败、HTTP 非 2xx、响应超限或解析失败时会分别以network/http/too_large/invalid/application错误码降级为unavailable快照fetchState: unavailable并标记retryable: true避免用量展示失败影响正常使用。小结接入 MiniMax 到 Kilo Code 的完整链路为MiniMax 控制台申请 Key → 在 Kilo Code 的 Providers 页或kilo.json中配置环境变量或env声明→ 设置默认模型minimax/MiniMax-M1。对于订阅了 MiniMax Token Plansk-cp前缀 Key的用户Kilo Code 还会在用量面板中展示各模型的区间/周配额与剩余量相关归一化逻辑与区域端点均可在 usage.ts 与 native.ts 中查阅。如需了解其他提供商接入可参考 ai-providers 目录 下的对应指南。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考