VisionEngine：如何选择模块并读取结果

摘要

• 根据文档中的挑战类型和图片布局选择合适的 VisionEngine 模块。
• 在准备图片输入前，先查看该模块对应的请求示例。
• 从 createTask 的响应中读取识别结果。
• 在将结果交给你的应用程序前，先校验预期的 solution 字段。

VisionEngine 客户端需要同时做出两个决定：选择哪个模块，以及该模块对应哪些图片、应用应期望什么结果。一个假定所有图片任务都返回文本的解析器，会把有效的旋转角度或距离结果当成无效数据丢弃。

CapSolver 在本指南中记录了相关的请求与响应字段。

将模块与图片布局匹配起来

先查看官方模块表中的截图和请求示例。对于与 rotate_1 示例匹配的旋转类布局，文档中的请求包含前景图和背景图。slider_1 示例同样包含这两个字段，但其输出代表的是距离。保持每张采集到的图片与其原始角色相对应。VisionEngine API 参考

在把通用参数表当成统一请求结构前，务必先查看具体模块的示例。只准备测试中已获授权挑战所需的图片。在准备文档中 Base64 字段时，去掉 data URL 前缀和所有换行。

从原始响应中读取结果

VisionEngine 参考文档描述了 createTask 的同步响应。先检查错误字段，再读取 solution。然后根据你提交的模块核对 solution 的结构。对于 rotate_1，示例中包含 angle 字段；对于 slider_1，则包含 distance 字段。当把结果交给应用代码时，要保持字段名与模块对应关系一致。任务创建参考

兑换你的 CapSolver 优惠码

立刻提升你的自动化预算！
在为 CapSolver 账户充值时使用优惠码 CAP26，每次充值即可额外获得 5% 奖励，没有次数或金额上限。
现在就去你的 CapSolver 控制台 进行兑换。

将识别检查与应用检查分离

记录模块、响应状态以及是否存在预期的 solution 字段。如果该字段缺失，在修改解析器前，先将提交的模块与图片布局对照其参考示例。在自有测试环境中，将应用是否接受结果与识别结果分开记录。对于服务错误，以文档中的错误码为排查起点。API 错误码

在使用 CapSolver 时，请遵守文档中的请求契约，并将应用执行结果单独检查。

常见问题

问：VisionEngine 需要轮询 getTaskResult 吗？

VisionEngine 文档描述的结果，是包含在 createTask 响应中的。

问：我能否为所有模块共用一个结果解析器？

你可以共用错误处理逻辑。但要为每个受支持模块分别校验 solution 的结构。

问：如果结果看起来不对，我首先应该检查什么？

对比挑战布局、所选模块和图片角色，确认它们与官方对应示例一致。