整题识别（含公式）API 简介

概念解释

整题识别（含公式）服务：基于有道机器学习团队业界领先的深度学习技术，将自然场景下图片上的题目文字、数字及公式信息，通过定位和检测，智能识别为可编辑的文本信息，轻松实现题目电子化。

说明

Hi，您好，欢迎使用有道智云整题识别（含公式）OCR API接口服务。

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

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

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

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

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

客服QQ：1906538062

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

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

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

温馨提示：

本文档主要针对开发人员接入测试前需要获取应用ID和应用密钥；如果您还没有，请按照新手 指南操作 。

平台向每个账户赠送50元的体验金，供用户集成前测试所用，具体资费规则详见 整题识别（含公式）OCR服务报价 。

接口说明

整题识别（含公式） API HTTPS地址：

https://openapi.youdao.com/ocr_formula

协议须知

调用方在集成整题识别（含公式）OCR API时，请遵循以下规则。

接口调用参数

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

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

具体示例如下：

1. 比如：img="Welcome to youdao AICloud.",字符串长度为26，大于20，其input="Welcome to"(前10个字符) + 26（字符串长度） + "o AICloud."（q字符串后10个字符）。
2. 比如：img = "sdT4bWrjS"，字符串长度为9，小于20，input = "sdT4bWrjS".

注意:

1. 请先将需要识别的图片转换为 Base64 编码。
2. 在发送HTTP请求之前需要对各字段做 URL encode。
3. 在生成签名拼接 应用ID+input+salt+curtime+应用密钥 字符串时，q 不需要做 URL encode，在生成签名之后，发送 HTTP 请求之前才需要对要发送的 img 做URL encode。
4. 签名和请求有疑问，可以参考文档最后的常用语言demo

输出结果

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

注意：boundingBox：坐标，共八个值：分别是左上角坐标(x,y)，右上角坐标(x,y)，右下角坐标(x,y)，左下角(x,y)，原点为左上角坐标。

示例

返回结果示例：

{
    "errorCode": "0",
    "Result": {
        "orientation": "",
        "regions": [{
            "boundingBox": "13,15,584,15,584,83,13,83",
            "dir": "h",
            "lang": "",
            "lines": [
                [{
                    "boundingBox": "13,22,110,22,110,76,13,76",
                    "text_height": 53,
                    "words": [{
                        "boundingBox": "13,23,74,22,74,75,13,76",
                        "word": "13."
                    }, {
                        "boundingBox": "86,22,110,22,110,75,86,75",
                        "word": "若"
                    }],
                    "text": "13.若",
                    "type": "text"
                }, {
                    "boundingBox": "111,15,326,15,326,82,111,82",
                    "text_height": 67,
                    "words": [{
                        "boundingBox": "111,15,326,15,326,82,111,82",
                        "word": " x = ( \\sqrt { 3 } { - 5 } ) ^ { 3 }"
                    }],
                    "text": "x = ( \\sqrt { 3 } { - 5 } ) ^ { 3 }",
                    "type": "formula"
                }, {
                    "boundingBox": "327,22,384,22,384,76,327,76",
                    "text_height": 53,
                    "words": [{
                        "boundingBox": "327,22,338,22,338,75,327,75",
                        "word": "，"
                    }, {
                        "boundingBox": "350,23,384,23,384,76,350,76",
                        "word": "则"
                    }],
                    "text": "，则",
                    "type": "text"
                }, {
                    "boundingBox": "385,15,584,15,584,83,385,83",
                    "text_height": 67,
                    "words": [{
                        "boundingBox": "385,16,584,15,584,82,385,83",
                        "word": " \\sqrt { - x - 1 } ="
                    }],
                    "text": "\\sqrt { - x - 1 } =",
                    "type": "formula"
                }]
            ]
        }],
        "exif": "UP"
    }
}

服务配置

错误代码列表

版本更新记录

常用语言 Demo

Java 示例
整题识别（含公式） java demo

Python 示例

整题识别（含公式） python3 demo

C# 示例

整题识别（含公式） c# demo

PHP 示例

整题识别（含公式） php demo

Go 示例

整题识别（含公式） go demo