Kimi可直接解析Flask/FastAPI单文件源码，提取静态路由、参数位置与类型、状态码及响应示例；需确保路由为字符串字面量、参数带类型注解、响应含显式status_code或标准字典。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把写好的Python Flask或FastAPI项目，快速生成符合Swagger规范的API文档，但又不想手动写OpenAPI YAML、不熟悉pydantic模型注解、也不愿安装额外插件——Kimi能直接解析源码并输出结构化接口描述。
准备待解析的API代码文件
将你的后端接口代码保存为单个.py文件，例如app.py，确保其中包含明确的路由装饰器（如@app.route或@router.get）和可识别的请求参数声明（query/body/path）。不要把路由分散在多个模块里，Kimi当前无法跨文件追踪导入的路由对象。
确认代码中没有使用动态拼接的路由路径，比如@app.route('/user/' + role)——这种写法会让Kimi无法提取路径字符串，【必须是静态字符串字面量】。
向Kimi提交解析请求
打开Kimi网页或App，在对话框中粘贴以下指令：
“请解析以下Python Web接口代码，提取所有HTTP方法、路径、请求参数（标注位置：query/path/body）、响应状态码及返回示例。按接口分组输出，每组包含：接口名称、方法、路径、参数列表（含类型、是否必需、说明）、成功响应示例（JSON格式）。只输出纯文本结果，不要解释过程。”
紧接着换行，粘贴你的app.py全部内容。注意不要截断装饰器或函数体，尤其要保留参数类型注解（如user_id: int）和FastAPI的Query/Body调用。
一键设置，在 OpenClaw 和 Claude Code CLI 中使用 Kimi K2.5 (Kimi Code) 作为编程模型。Kimi Code 兼容 Anthropic Messages API——替换……
清洗与补全Kimi输出结果
方法一：人工校验关键字段
检查Kimi返回的每个接口是否都列出了status_code。如果某接口缺失该字段，说明Kimi没识别到return JSONResponse(status_code=...)或return {"msg": "ok"}这类典型响应模式，需回到原代码补上显式状态码或标准字典返回。
方法二：注入OpenAPI兼容格式
将Kimi输出的参数列表逐条转换为OpenAPI 3.0.3的schema字段：把str映射为type: string，int映射为type: integer，带default=...的标"required": false，否则标"required": true。这一步必须做，否则后续导入Swagger UI会报错。
方法三：拼接成完整YAML
第一步：复制Kimi输出的接口描述块；第二步：在顶部添加OpenAPI基础头信息（openapi: 3.0.3、info、servers）；第三步：将每个接口按paths路径嵌套进paths:下，路径用引号包裹（如"/user/{id}":）；第四步：把补全后的参数写入parameters或requestBody对应位置。注意缩进必须用空格，不能用Tab。
