图像矫正 API 简介

概念解释

图像矫正服务，对图片进行方向矫正、效果增强、去除卷曲等操作，对压缩后的图像还原清晰图像，提升图像的质量。可与图像矫正、手写文字识别、试卷手写体擦除等服务搭配使用，提升文字内容辨识度和综合识别效果。

说明

Hi，您好，欢迎使用有道智云图像矫正 API接口服务。

如果您想快速体验服务，建议您前往 体验中心 或者在体验中心右下侧找到小程序二维码，扫描进行体验。

本文档主要针对需要集成HTTP API的技术开发工程师，详细描述OCR识别能力相关的技术内容。

如果您有与我们商务合作的需求，可以通过以下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

客服QQ：1906538062

智云OCR技术交流QQ 1群: 654064748

智云OCR技术交流QQ 2群: 471638046

联系邮箱： zhiyun@corp.youdao.com

温馨提示：

• 本文档主要针对开发人员，接入测试前需要获取应用ID和应用密钥；如果您还没有，请按照 新手指南 获取。
• 平台向每个账户赠送50元的体验金，供用户集成前测试所用，具体资费规则详见 图像矫正服务报价 。

接口能力

有道智云图像矫正 API接口提供OCR图像矫正服务，您只需要通过调用有道智云OCR API，传入经过Base64编码的图片，通过POST请求方式，就可以得到相应的图像矫正结果。

有道智云图像矫正 API HTTPS地址：

https://openapi.youdao.com/ocr_dewarp

协议须知

调用方在集成图像矫正 API时，请遵循以下规则。

接口调用参数

调用API需要向接口发送以下字段来访问服务。

签名生成方法如下：

signType=v3；
sign=sha256(应用ID+input+salt+curtime+应用密钥)；
其中，input的计算方式为：input=q前10个字符 + q长度 + q后10个字符（当q长度大于20）或 input=q字符串（当q长度小于等于20）；

如果对签名有疑问，可以参看文档末尾各语言demo。

输出结果

返回的结果是json格式，具体说明如下：

correctionSymbols 即为保存了该文档中符号信息的字典，例如：

{'symbolRegions': [{'boundingBox': '0,231,66,231,66,304,0,304'},
{'boundingBox': '2,951,47,951,47,996,2,996'},
{'boundingBox': '373,119,431,119,431,185,373,185'},
{'boundingBox': '68,1025,118,1025,118,1091,68,1091'}]}

具体可参见下面的参考示例。

参考示例

识别的返回结果：

{
    "errorCode": "0",
    "msg": "SUCCESS",
    "requestId": "534fb4c9-6490-41ce-9dd2-c416f68f579c",
    "dewarpResults": [{
        "dewarped": "/9j/4AAQSkZJRgABAQA==......",  //图片base64
        "docType": "A3_3",
        "correctionSymbol": "{\"symbolRegions\":[],\"symbolLabels\":[]}",
        "isDewarped": "true"
    }],
    "originalImg": "/9j/4AAQSkZJRgABAgA==......" //图片base64
}

服务配置

错误代码列表

常用语言 Demo

Java 示例

图像矫正 Java demo

Python3 示例

图像矫正 python3 demo

C#示例

图像矫正 c# demo

PHP 示例

图像矫正 php demo

go 示例

图像矫正 go demo

常见问题

可参考图像矫正服务常见问题查阅解决方案，若未能解决问题可联系相关技术同学沟通。