测试用例的编写是 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 功能是经过 Apifox 服务端访问大模型的,故当前只支持国内的模型提供商。
设置默认模型,启用相关功能
当你使用 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 的更多可能。