使用MiniMax Code自动生成接口文档，核心流程可归纳为三个关键步骤：准备原始材料、编写精准提示词、校验生成结果。然而，每个环节都隐藏着容易忽略的细节，一旦遗漏，生成的文档可能无法直接用于开发联调，导致返工。

首先，需要准备好原始接口材料。这一步的关键在于明确你手中的输入源类型。

如果输入源是Swagger 2.0或OpenAPI 3.x规范的JSON文件，直接保存为openapi.json即可。从Postman导出的Collection，请务必选择v2.1格式，并导出为JSON。若只有文字描述，则必须确保包含以下三项核心信息：接口URL、HTTP方法、关键请求参数（包括名称、类型、是否必填、示例值）。这三项缺一不可——缺少任意一项，MiniMax Code生成的文档都将缺失核心字段，导致后续开发联调时因参数理解偏差而频繁出现400错误，排查成本极高。

文件准备完成后，将其放置在项目根目录，并命名为api_source.json。采用固定命名是一个实用技巧，可以避免在后续Prompt中反复指定路径，从而降低模型误读的概率。

接下来是构造提示词。打开MiniMax Code对话界面，将以下Prompt粘贴进去，注意不要修改任何占位符：

“请根据提供的api_source.json内容，生成符合国内后端团队阅读习惯的中文接口文档。要求：① 按「接口概览→请求说明→请求参数→响应参数→示例」五部分组织；② 请求参数表格必须包含【字段名】【类型】【是否必填】【说明】【示例值】五列；③ 响应参数若含嵌套对象，需用缩进+破折号展开至二级字段；④ 最后给出一个完整的curl命令示例，Header中Authorization值写为Bearer YOUR_API_KEY，URL和body按实际填充。”

这里有一个容易忽略的细节——务必包含“国内后端团队阅读习惯”这个限定。MiniMax M2.7模型在训练时，对国内技术文档的语序有强烈的偏好，例如“必填”字段前置、“示例值”单独成列。如果遗漏这个限定，生成的表格列顺序可能错乱，比如“说明”被挤到最后一列，影响阅读体验。

点击发送后，等待3到8秒，生成结果将以Markdown块形式返回。此时需要立即检查三个关键位置：【是否必填】列是否存在空值、【示例值】是否全部为真实可运行的字符串或数字（而不是null或example_string）、curl命令中的-X POST是否与接口实际方法一致（例如GET接口误写成POST，会误导前端开发人员）。

如果发现任意一项异常，必须重新生成——MiniMax Code不会自动修正已输出的错误字段，二次编辑只会污染文档结构。确认无误后，全选生成内容，复制，新建一个API_DOC.md文件，粘贴保存即可。