接口调用常见问题-文字识别(OCR)-阿里云帮助中心

本章节介绍阿里云文字识别（OCR）关于API/SDK相关的常见问题与解答。

接口调用报错的常见原因有哪些？

接口调用报错时，您可以尝试以下步骤进行排查：

检查参数格式：确保传入的参数格式正确。如果使用url参数，需确保URL为公网可访问地址；如果使用body参数，需要将图片文件转换为二进制传入。
检查接口调用代码：参考调用文字识别OCR接口，确保您的代码中正确配置了AccessKeyId和AccessKeySecret，并且指定了正确的Endpoint。
查看错误信息：根据返回的错误信息，进一步诊断问题。您可以参考错误码诊断来获取详细的错误信息和推荐处理方案。

此外，以下为常见报错场景及排查方法：

AccessKey 配置错误：报错 Specified access key is not found or invalid 或 The specified credentials file is not exist 时，请检查：AK/SK 是否正确配置；是否使用了开通 OCR 服务的账号所对应的 AK/SK（跨账号场景需特别注意）；代码中签名拼接是否正确（建议参考官方示例代码）。
Type 参数非法：报错 Specified parameter Type is not valid 时，请确认调用 RecognizeAllText 等通用接口时传入的 Type 枚举值合法。例如，识别营业执照时对应枚举值为 BusinessLicense，具体取值请参考对应接口的 API 文档。
图片类型不匹配：报错 unmatchedImageType 时，表示图片内容与接口场景不符（例如在身份证识别接口中传入了非身份证图片）。建议更换清晰合规的图片，或改用百炼平台的 Qwen-OCR 模型处理复杂场景。
接口白名单限制：部分接口（如飞机行程单识别）返回 400 错误时，可能是因为未申请相应接口的访问权限。请按照对应接口文档中的说明提交白名单申请。

如果以上步骤仍无法解决问题，请通过钉钉加入答疑群（群号码：35208328），以获取问题解答和支持。

建议您使用在线调试，如果使用HTTP调用需要自行计算签名等一些参数，比较麻烦。您可以在阿里云OpenAPI文字识别在线调试成功之后，下载完整工程到您的项目中使用即可，SDK已经封装好了计算签名等一些公共参数的方法，能够显著简化开发过程，降低错误率，提高开发效率和代码的可维护性。

在调试页面顶部单击SDK 示例标签页可查看多语言 SDK 代码示例，单击运行示例按钮可在线运行代码。

建议通过 HTTP 方式接入百炼平台的 Qwen-OCR 模型接口。Qwen-OCR 模型支持图纸文字识别等多种场景，适合与 Hermes 等 Agent 框架或第三方应用集成。