MiMo Code 这款工具,简单来说就是让你通过日常用语描述需求,然后由它自动完成 API 请求的构建、调试和执行,形成一站式的自动化流程。它并非传统意义上的 API 请求生成器,但其核心创新在于:将“手动编写请求”转变为“语音描述需求”,随后 AI 自动补全结构、填充参数、校验格式,甚至顺手完成一次测试运行。

通俗地讲,MiMo Code 并不依赖手动拼接 URL 和 JSON,而是通过“上下文感知 + 工具调用 + 模式切换”这一组合策略实现自动化。它会先读取项目中的 OpenAPI 规范、Swagger 文件或是已有代码中的请求示例,再结合你自然语言描述的目标(例如“调用用户登录接口,传入手机号和验证码”),自动生成可执行的 curl 或 Python requests 脚本,并支持一键运行与结果解析。
三步实现自动化 API 请求构建
第一步:确保环境就绪
- 当前目录下必须放置清晰的 API 文档(如 openapi.json、swagger.yaml),或已有的请求代码(requests.py、curl.sh 均可)。
- 已配置好可用的模型(推荐
mimo-v2.5-pro),可通过/connect切换并确认。 - 网络畅通,能够访问小米 MiMo 平台或你的自定义 API 服务端。
第二步:用 Compose 模式发起任务
- 输入
mimo进入交互界面后,键入/compose切换至编排模式。 - 直接描述你的需求,例如:
“帮我构造一个 POST 请求,调用 https://api.example.com/v1/auth/login,header 带 Authorization Bearer xxx,body 是 {"phone":"138****1234", "code":"654321"},返回成功后打印 token”。 - MiMo Code 会自动识别协议、方法、路径、鉴权方式以及数据结构,并生成包含错误处理机制的可执行脚本。
第三步:执行 & 迭代优化
- 生成脚本后,它会询问是否立即运行(输入 y 即可);你也可以先输入
/edit进行查看或微调。 - 如果请求返回异常(比如 401 或 400),MiMo Code 会主动分析错误体并给出修改建议(例如“Authorization 头中缺少空格”或“code 字段应为字符串”)。
- 支持将成功请求保存为模板:输入
/sa ve login-api,之后可复用或参数化调用。
对接自定义 API 的关键配置项
若你的 API 并非标准 OpenAI 兼容格式,需提前在 MiMo Code 中声明行为规则:
- 在项目根目录下添加
.mimo/config.json,配置非标字段的映射关系。例如:{"auth_header": "X-API-Key", "response_key": "data.result"} - 对于需要签名的请求(如 HMAC),可启用内置
signer插件:/plugin enable signer,然后描述“用 secret_key 对 body 和 timestamp 签名”。 - 若 API 返回二进制或流式内容(例如文件下载),MiMo Code 默认会根据 content-type 自动识别,并直接保存为文件,无需额外指令。
进阶:用 Plan 模式批量生成请求集合
此方法特别适合对接整套 RESTful 或 GraphQL 接口:
- 输入
/plan,然后提供接口文档路径或直接粘贴接口列表。 - 说明你的目标:“生成全部 CRUD 请求脚本,按资源分组,每个请求都附带 mock 测试数据”。
- MiMo Code 将输出结构化的目录,例如
requests/users/、requests/orders/,其中包含 curl、Python 脚本以及参数说明的 README。 - 后续你可直接通过
mimo run requests/users/list.py执行。
