Doc AI OCR API请求中processOptions字段未被识别的原因咨询

问题场景 #

你遇到的情况是：为优化OCR识别（如"I"被识别为"1"），在请求中添加processOptions字段后触发错误，移除该字段则请求正常。错误信息如下：

{
...
"message": "Invalid JSON payload received. Unknown name "processOptions": Cannot find field."
...
}
使用的处理器版本为pretrained-ocr-v1.2-2022-11-10，且已确认请求格式符合参考示例，但仍报错。

核心原因 #

你使用的pretrained-ocr-v1.2-2022-11-10版本OCR处理器不支持processOptions字段，接口的参数校验逻辑会直接拦截包含未定义字段的请求，所以无论用Postman还是自定义APEX代码发送请求，只要携带该字段就会触发上述错误。

具体细节说明 #

• 版本迭代差异：processOptions大概率是该OCR处理器后续版本才新增的配置字段，你当前使用的2022年11月的v1.2版本，接口定义里还没有这个参数项。
• 文档版本不匹配：你参考的请求示例可能对应更新的处理器版本，和你实际使用的v1.2版本的接口规范不一致，导致按示例配置后报错。

优化识别问题的替代建议 #

既然v1.2版本不支持processOptions，想要解决"I"被识别为"1"这类问题，可以查看该版本官方提供的参数文档，寻找对应版本支持的字符校正、识别精度调整类参数，比如部分旧版本会提供enableCharacterCorrection这类针对性开关，而非使用新版本的processOptions字段。

内容的提问来源于stack exchange，提问作者N4go