如何在 Apifox 中通过 AI 一键生成几十个测试用例?

测试用例的编写是 API 开发中比较耗时的环节,需要覆盖正常、异常、边界值、安全性等多种场景,手动编写时一般需要花费大量的时间。
好在 Apifox 现在已支持通过 AI 来自动生成测试用例——可根据接口结构,智能生成覆盖多种测试场景的完整用例集。
AI 生成测试用例的效果
一键快速生成大量用例
点击「生成」按钮后,几十秒内就能看到大量结构完整的用例出现在列表中。

自动分类用例类型
AI 生成的用例会按照正向、负向、边界值、安全性等测试类型进行归类。

即时运行验证效果
生成的用例可以立即运行,实时查看接口响应。不需要等待 AI 将所有用例生成后再操作,满意的用例可以直接采纳到接口的正式测试用例集中。

批量操作高效管理
生成的用例可以批量运行、批量采纳或废弃,便于快速筛选高质量用例。

多任务并行对比
支持同时启动多个生成任务,方便对比不同 AI 模型的生成效果与质量。

欢迎在 Apifox 中体验更多效果。
如何开启 AI 功能?
在开始使用「AI 生成测试用例」功能之前,需要先完成一些基础配置。AI 功能在 Apifox 中默认是关闭状态,需要手动开启。
要启用 AI 功能,你首先需要确保自己有足够的权限,这个功能目前需要组织或团队管理员及以上权限才能配置,同时请确保将 Apifox 更新到最新版本。
开启的路径很简单:进入「组织 / 团队设置 - AI 功能」,在这里可以为整个组织或团队开启 AI 能力。一旦开启,团队内的所有项目都可以使用 AI 功能。

开启 AI 功能后,你会看到一个新的配置入口出现——AI 模型供应商配置。这就引出了下一个需要解决的问题:选择和配置 AI 供应商。
配置 AI 供应商
开启 AI 功能后,你需要配置至少一个 AI 供应商。Apifox 目前默认支持火山引擎、阿里云百炼、腾讯云、硅基流动和 DeepSeek 等国内供应商,也支持通过自定义 API 配置接入其他供应商。

配置时需要提供几个关键信息:
- API Key:调用 AI 接口的身份验证凭证,配置完可以测试验证是否有效
- API 前置 URL:实际请求发送的地址,预设供应商会自动填充
- 模型列表:选择要启用的具体模型,只有启用的模型才能在功能中使用

这里有个重要提醒:要想获得好的生成效果,请务必选择先进强大的模型(如 DeepSeek 3.2),能力较弱的模型可能导致生成结果不符合预期。
设置默认模型,启用相关功能
当你使用 AI 功能时没有特别指定模型的情况下,系统会自动选择。你也可以指定某个具体模型,并启用你需要的 AI 功能。

当模型供应商配置完成,并启用相关的 AI 功能后,重新刷新你打开的项目,应该就能看到各个 AI 功能的入口了。
使用 AI 生成测试用例
在任意接口的「测试用例」标签下,你会看到「通过 AI 生成」的入口。

点击后右侧会滑出配置面板,这里可以选择要生成的用例类型。你可以按照正向、负向、边界值、安全性及其相关子项进行勾选,AI 会根据选择生成对应类型的用例。

如果接口需要鉴权,系统会自动识别配置的鉴权凭证。密钥值会在本地加密传递,生成完成后自动解密,既保证功能使用又保障信息安全。

在正式生成前,可以在底部输入框添加更多具体要求,帮助 AI 生成更符合预期的用例。左下角可以设置生成数量,最多支持一次生成 80 个用例,右下角可以选择使用的 AI 模型。

点击生成后,AI 基于接口文档和配置要求开始工作。生成的用例可以立即运行验证,通过实际响应判断是否符合预期。对于符合要求的用例点击「采纳」,不需要的点击「废弃」,也可以批量处理多个用例。

使用 AI 生成测试用例的时候,接口文档越完善,AI 生成的用例效果就越好。
例如,在接口定义中为每个枚举值都补充了具体含义,AI 就能自动生成覆盖所有枚举值的完整测试用例,并在部分场景下应用正交法生成更合理的组合。
后续版本中,Apifox 将在接口用例中支持配置测试数据,AI 可自动生成并填充相应测试数据,以进一步提升测试效率。
更多 AI 功能
除了生成测试用例,Apifox 的 AI 功能还可辅助完成多项智能操作:
修改数据模型
在「组织 / 团队设置 - AI 功能」中启用“AI 辅助参数修改”功能后,重新刷新项目。
在接口文档、数据模型页面中,鼠标悬停到数据模型相关区域,即可看到 AI 功能入口,点击即可用 AI 修改数据模型。

接口规范性检测
在「组织 / 团队设置 - AI 功能」中启用“接口规范性检测”功能后,重新刷新项目。
在项目中新建一个接口设计规范后,即可在任意接口中通过 AI 来检测接口设计规范。

字段命名
在「组织 / 团队设置 - AI 功能」中启用“AI 命名”功能后,重新刷新项目。
在接口文档、数据模型页面中,鼠标悬停到字段名称区域,即可看到 AI 功能入口,点击即可进行使用,AI 会根据你们团队的接口设计规范提供符合规范的字段命名建议。

AI 生成测试用例功能,可以根据接口结构自动生成覆盖正常、异常、边界值、安全性等多种场景的测试用例,生成的用例可立即运行、验证接口响应,并支持批量采纳或废弃。测试人员无需再重复编写大量基础用例,可以把更多精力投入到验证逻辑和优化测试策略上,以此提升整体测试效率。
除了用 AI 生成测试用例外,还有更多其他 AI 功能,详细使用方法可以查看 Apifox 的帮助文档。
欢迎在飞书或企微群交流更多使用技巧,和大家一起探索 Apifox AI 的更多可能。
