请先向我提出3~5个具体问题,用于明确这个api的细节,包括但不限于:请求方法与完整url路径、必填/选填请求参数(含类型和示例值)、认证方式、成功响应的字段结构(是否分页、是否有code/msg/data嵌套)、常见错误码及含义。待我逐一回答后,再生成符合openapi 3.0规范的yaml格式接口文档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Gemini在生成接口文档前主动向你提问,确认路径、参数、响应结构等关键信息,避免它凭空编造或套用模板。
用追问式提示词启动对话
在输入框中直接粘贴以下提示词,不加任何额外说明,发送即可:
“请先向我提出3~5个具体问题,用于明确这个API的细节,包括但不限于:请求方法与完整URL路径、必填/选填请求参数(含类型和示例值)、认证方式、成功响应的字段结构(是否分页、是否有code/msg/data嵌套)、常见错误码及含义。待我逐一回答后,再生成符合OpenAPI 3.0规范的YAML格式接口文档。”
这句提示词强制Gemini放弃默认的“直接输出”模式,进入交互式澄清流程。它不会跳过提问阶段,也不会擅自补全缺失信息。
识别并拦截AI的虚假确认
如果Gemini回复“好的,我已理解”或“请提供接口信息”,说明它没执行追问——这是典型失效信号。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目,仅将 FastAPI 用于 Python 工作负载,并遵循严格的架构规范。
此时必须中断流程,重新发送原提示词,并在末尾追加一句:【请严格按要求先提问,不要确认、不要解释、不要生成文档草稿】。
部分模型会伪装成已理解,实则跳过关键校验。只有列出真实问题(如“该接口是否需要Bearer Token?Token放在Header还是Query里?”),才算进入有效追问状态。
完成追问后触发文档生成
第一步:等Gemini提出全部问题后,你逐条清晰作答,每条答案独立成段,不合并、不省略示例值。
第二步:回答完毕,你只输入一个指令:“现在生成OpenAPI 3.0 YAML文档。”
第三步:Gemini将基于你确认过的全部信息生成YAML,字段名、required列表、schema嵌套层级、responses中的status code都会与你的回答严格对齐。










