印刷文字识别(多语种) API 文档
接口说明
印刷文字识别(多语种),基于深度神经网络模型的端到端文字识别系统,将图片(来源如扫描仪或数码相机)中的字体转化为计算机可编码的文字,支持中文、英文、日语、韩语、俄语。
该能力是通过HTTP API的方式给开发者提供一个通用的接口。HTTP API适用于一次性交互数据传输的AI服务场景,块式传输。相较于SDK,API具有轻量、跨语言的特点。另外,请注意该接口使用的HTTP API协议不支持跨域。
接口Demo
示例demo请点击 这里 下载。
demo 覆盖部分语言,其他语言参照下方接口文档进行开发。
欢迎热心的开发者到“讯飞开放平台社区” 分享你们的demo。
接口要求
集成印刷文字识别(多语种)API时,需按照以下要求。
| 内容 | 说明 | 
|---|---|
| 传输方式 | http[s] (为提高安全性,强烈推荐https) | 
| 请求地址 | http[s]: //api.xf-yun.com/v1/private/s00b65163 注:服务器IP不固定,为保证您的接口稳定,请勿通过指定IP的方式调用接口,使用域名方式调用  | 
| 请求行 | POST /v1/private/s00b65163 HTTP/1.1 | 
| 接口鉴权 | 签名机制,详情请参照下方鉴权认证 | 
| 字符编码 | UTF-8 | 
| 响应格式 | 统一采用JSON格式 | 
| 开发语言 | 任意,只要可以向讯飞云服务发起HTTP请求的均可 | 
| 适用范围 | 任意操作系统,但因不支持跨域不适用于浏览器 | 
| 图片格式 | jpg/jpeg/png/bmp | 
| 图片大小 | base64编码后大小不超过4M | 
接口调用流程
· 通过接口密钥基于hmac-sha256计算签名,将签名以及其他参数加在请求地址后面。详见下方 鉴权认证 。
· 将请求参数以及图片数据放在Http Request Body中,以POST表单的形式提交,详见下方 请求参数 。
· 向服务器端发送Http请求后,接收服务器端的返回结果。
鉴权认证
在调用业务接口时,请求方需要对请求进行签名,服务端通过签名来校验请求的合法性。
鉴权方法
通过在请求地址后面加上鉴权相关参数的方式,参数具体如下:
http示例url:
https://api.xf-yun.com/v1/private/s00b65163?host=api.xf-yun.com&date=Mon%2C+30+Nov+2020+01%3A28%3A44+GMT&authorization=YXBpX2tleT0iOGFiZDI4ZTFkYjU1YWVjMDJmYWMwOWU2ZjMyY2QyMzciLCBhbGdvcml0aG09ImhtYWMtc2hhMjU2IiwgaGVhZGVycz0iaG9zdCBkYXRlIHJlcXVlc3QtbGluZSIsIHNpZ25hdHVyZT0ibEZROWRwK1ptb0ZlV0JxTDN3K1VMOFF1TDNhMkR1OGszcWEveS9aalovST0i
鉴权参数:
| 参数 | 类型 | 必须 | 说明 | 示例 | 
|---|---|---|---|---|
| host | string | 是 | 请求主机 | api.xf-yun.com | 
| date | string | 是 | 当前时间戳,RFC1123格式("EEE, dd MMM yyyy HH:mm:ss z") | Mon, 30 Nov 2020 01:28:44 GMT | 
| authorization | string | 是 | 使用base64编码的签名相关信息(签名基于hamc-sha256计算) | 参考下方详细生成规则 | 
· date参数生成规则:
date必须是UTC+0或GMT时区,RFC1123格式(Mon, 30 Nov 2020 01:28:44 GMT)。
服务端会对date进行时钟偏移检查,最大允许300秒的偏差,超出偏差的请求都将被拒绝。
· authorization参数生成格式:
1)获取接口密钥APIKey 和 APISecret。
在讯飞开放平台控制台,创建一个应用后打开印刷文字识别(多语种)页面可以获取,均为32位字符串。
2)参数authorization base64编码前(authorization_origin)的格式如下。
api_key="$api_key",algorithm="hmac-sha256",headers="host date request-line",signature="$signature"
其中 api_key 是在控制台获取的APIKey,algorithm 是加密算法(仅支持hmac-sha256),headers 是参与签名的参数(见下方注释)。
signature 是使用加密算法对参与签名的参数签名后并使用base64编码的字符串,详见下方。
注: headers是参与签名的参数,请注意是固定的参数名("host date request-line"),而非这些参数的值。
3)signature的原始字段(signature_origin)规则如下。
signature原始字段由 host,date,request-line三个参数按照格式拼接成,
拼接的格式为(\n为换行符,’:’后面有一个空格):
host: $host\ndate: $date\n$request-line
假设
请求url = api.xf-yun.com
date = Mon, 30 Nov 2020 01:28:44 GMT
那么 signature原始字段(signature_origin)则为:
host: api.xf-yun.com
date: Mon, 30 Nov 2020 01:28:44 GMT
POST /v1/private/s00b65163 HTTP/1.1
4)使用hmac-sha256算法结合apiSecret对signature_origin签名,获得签名后的摘要signature_sha。
signature_sha=hmac-sha256(signature_origin,$apiSecret)
其中 apiSecret 是在控制台获取的APISecret
5)使用base64编码对signature_sha进行编码获得最终的signature。
signature=base64(signature_sha)
假设
APISecret = apisecretXXXXXXXXXXXXXXXXXXXXXXX	
date = Mon, 30 Nov 2020 01:28:44 GMT
则signature为
signature=rBvc60DZ69Umj/EXfDNf1BDwzmIuCFx2hL41GvD0xi0=
6)根据以上信息拼接authorization base64编码前(authorization_origin)的字符串,示例如下。
api_key=api_key="apikeyXXXXXXXXXXXXXXXXXXXXXX", algorithm="hmac-sha256", headers="host date request-line", signature="rBvc60DZ69Umj/EXfDNf1BDwzmIuCFx2hL41GvD0xi0="
注: headers是参与签名的参数,请注意是固定的参数名("host date request-line"),而非这些参数的值。
7)最后再对authorization_origin进行base64编码获得最终的authorization参数。
authorization = base64(authorization_origin)
示例:
authorization=YXBpX2tleT0iYXBpa2V5WFhYWFhYWFhYWFhYWFhYWFhYWFhYWCIsIGFsZ29yaXRobT0iaG1hYy1zaGEyNTYiLCBoZWFkZXJzPSJob3N0IGRhdGUgcmVxdWVzdC1saW5lIiwgc2lnbmF0dXJlPSJyQnZjNjBEWjY5VW1qL0VYZkROZjFCRHd6bUl1Q0Z4MmhMNDFHdkQweGkwPSI=
鉴权结果
如果鉴权失败,则根据不同错误类型返回不同HTTP Code状态码,同时携带错误描述信息,详细错误说明如下:
| HTTP Code | 说明 | 错误描述信息 | 解决方法 | 
|---|---|---|---|
| 401 | 缺少authorization参数 | {"message":"Unauthorized"} | 检查是否有authorization参数,详情见authorization参数详细生成规则 | 
| 401 | 签名参数解析失败 | {“message”:”HMAC signature cannot be verified”} | 检查签名的各个参数是否有缺失是否正确,特别确认下复制的api_key是否正确 | 
| 401 | 签名校验失败 | {“message”:”HMAC signature does not match”} | 签名验证失败,可能原因有很多。 1. 检查api_key,api_secret 是否正确。 2.检查计算签名的参数host,date,request-line是否按照协议要求拼接。 3. 检查signature签名的base64长度是否正常(正常44个字节)。  | 
| 403 | 时钟偏移校验失败 | {“message”:”HMAC signature cannot be verified, a valid date or x-date header is required for HMAC Authentication”} | 检查服务器时间是否标准,相差5分钟以上会报此错误 | 
签名校验失败示例:
HTTP/1.1 401 Forbidden
Date: Mon, 30 Nov 2020 02:34:33 GMT
Content-Length: 116
Content-Type: text/plain; charset=utf-8
{
    "message": "HMAC signature does not match"
}
请求参数
在调用业务接口时,都需要在 Http Request Body 中配置以下参数,请求数据均为json字符串。
| 参数名 | 类型 | 必传 | 描述 | 
|---|---|---|---|
| header | object | 是 | 用于上传平台参数 | 
| header.app_id | string | 是 | 在平台申请的appid信息 | 
| header.status | int | 是 | 请求状态,可选值:3(一次传完) | 
| parameter | object | 是 | 用于上传服务特性参数 | 
| parameter.s00b65163 | object | 是 | 用于上传功能参数 | 
| parameter.s00b65163.category | string | 是 | 服务特性参数,可选值:mix0(默认值) | 
| parameter.s00b65163.result | object | 是 | 用于上传响应数据参数 | 
| parameter.s00b65163.result.encoding | string | 否 | 文本编码,可选值:utf8(默认值) | 
| parameter.s00b65163.result.compress | string | 否 | 文本压缩格式,可选值:raw(默认值) | 
| parameter.s00b65163.result.format | string | 否 | 文本格式,可选值:json(默认值) | 
| payload | object | 是 | 用于上传请求数据 | 
| payload.s00b65163_data_1 | object | 是 | 用于上传图像数据 | 
| payload.s00b65163_data_1.encoding | string | 否 | 图像编码,jpg格式(默认值)/jpeg格式/png格式/bmp格式 | 
| payload.s00b65163_data_1.image | string | 是 | 图像数据,需保证图像文件大小base64编码后不超过4MB | 
| payload.s00b65163_data_1.status | int | 否 | 上传数据状态,可选值:3(一次传完) | 
请求参数示例:
{
    "header": {
        "app_id": "XXXXXX",
        "status": 3,
    },
    "parameter": {
        "s00b65163": {
            "category": "mix0",
            "result": {
                "encoding": "utf8",
                "compress": "raw",
                "format": "json"
            }
        }
    },
    "payload": {
        "s00b65163_data_1": {
            "encoding": "jpg",
            "image": "",
            "status": 3
        }
    }
}
返回参数
| 参数名 | 类型 | 描述 | 
|---|---|---|
| header | object | 协议头部,用于描述平台特性的参数 | 
| header.sid | string | 本次会话id | 
| header.code | int | 返回码 0表示会话调用成功(并不一定表示服务调用成功,服务是否调用成功以text字段中的ret为准) 其它表示会话调用异常,详情请参考错误码。  | 
| header.message | string | 描述信息 | 
| payload | object | 数据段,用于携带响应的数据 | 
| payload.result | object | 印刷文字识别(多语种)响应数据块 | 
| payload.result.compress | string | 压缩格式 | 
| payload.result.encoding | string | 编码格式 | 
| payload.result.format | string | 返回数据格式 | 
| payload.result.text | string | 印刷文字识别(多语种)返回结果,需要对其进行base64解码,解码后的返回字段如下 | 
payload.result.text字段具体信息如下 
| 字段 | 类型 | 描述 | 备注 | 
|---|---|---|---|
| category | string | 附加信息 | |
| version | string | 引擎版本号 | |
| pages | array | 页面集合 | |
| pages.exception | int | 异常返回 | 正常返回 0 异常返回 -1  | 
| pages.angle | float | 图像的旋转角度 | 范围[0, 360],顺时针方向 | 
| pages.height | int | 页面高度 | |
| pages.width | int | 页面宽度 | |
| pages.lines | array | 文本行集合 | |
| pages.lines.exception | int | 该文本行的异常返回 | 正常返回 0 异常返回 -1  | 
| pages.lines.conf | float | 置信度 | 取值范围[0-1] | 
| pages.lines.angle | float | 文本行的旋转角度 | |
| pages.lines.coord | array | 文本行坐标,记录4个顶点位置 | |
| pages.lines.words | array | 单词集合 | |
| pages.lines.word_units | array | 单字集合 | |
| pages.lines.coord.x | int | 文本行坐标4个顶点x轴的位置信息 | |
| pages.lines.coord.y | int | 文本行坐标4个顶点y轴的位置信息 | |
| pages.lines.words.content | string | 识别结果文本 | |
| pages.lines.words.coord | array | 文字坐标,记录4个顶点位置 | |
| pages.lines.words.coord.x | int | 文字坐标4个顶点x轴的位置信息 | |
| pages.lines.words.coord.y | int | 文字坐标4个顶点y轴的位置信息 | |
| pages.lines.word_units.content | string | 单字识别结果文本 | |
| pages.lines.word_units.coord | array | 单字坐标,记录4个顶点位置 | |
| pages.lines.word_units.coord.x | int | 单字坐标4个顶点x轴的位置信息 | |
| pages.lines.word_units.coord.y | int | 单字坐标4个顶点y轴的位置信息 | |
| pages.lines.word_units.center_point | array | 单字中心点的坐标 | |
| pages.lines.word_units.center_point.x | int | 单字中心点的坐标的x轴位置信息 | |
| pages.lines.word_units.center_point.y | int | 单字中心点的坐标的y轴位置信息 | 
返回参数示例:
{
  "header": {
    "code": 0,
    "message": "success",
    "sid": "ase000d664e@hu17616c416800212882"
  },
  "payload": {
    "result": {
      "compress": "raw",
      "encoding": "utf8",
      "format": "json",
      "text": "ewogImNhdGVnb3J5IjogIm1p..."
    }
  }
}
base64解码后的text示例:
{
  "pages": [
    {
      "exception": 0,
      "width": 698,
      "angle": 1.2244873,
      "lines": [
        {
          "exception": 0,
          "coord": [
            {
              "x": 93,
              "y": 53
            },
            {
              "x": 618,
              "y": 32
            },
            {
              "x": 621,
              "y": 108
            },
            {
              "x": 96,
              "y": 130
            }
          ],
          "words": [
            {
              "coord": [
                {
                  "x": 93,
                  "y": 53
                },
                {
                  "x": 253,
                  "y": 46
                },
                {
                  "x": 256,
                  "y": 123
                },
                {
                  "x": 96,
                  "y": 130
                }
              ],
              "content": "너하나"
            },
            {
              "coord": [
                {
                  "x": 254,
                  "y": 46
                },
                {
                  "x": 428,
                  "y": 39
                },
                {
                  "x": 432,
                  "y": 116
                },
                {
                  "x": 257,
                  "y": 123
                }
              ],
              "content": "때문에"
            },
            {
              "coord": [
                {
                  "x": 429,
                  "y": 39
                },
                {
                  "x": 543,
                  "y": 34
                },
                {
                  "x": 547,
                  "y": 111
                },
                {
                  "x": 433,
                  "y": 116
                }
              ],
              "content": "망진"
            },
            {
              "coord": [
                {
                  "x": 544,
                  "y": 34
                },
                {
                  "x": 616,
                  "y": 31
                },
                {
                  "x": 620,
                  "y": 108
                },
                {
                  "x": 548,
                  "y": 111
                }
              ],
              "content": "몸"
            }
          ],
          "angle": 2.38594413,
          "conf": 0,
          "word_units": [
            {
              "center_point": {
                "x": 129,
                "y": 84
              },
              "coord": [
                {
                  "x": 93,
                  "y": 53
                },
                {
                  "x": 164,
                  "y": 50
                },
                {
                  "x": 167,
                  "y": 127
                },
                {
                  "x": 96,
                  "y": 130
                }
              ],
              "content": "너"
            },
            {
              "center_point": {
                "x": 191,
                "y": 84
              },
              "coord": [
                {
                  "x": 165,
                  "y": 50
                },
                {
                  "x": 216,
                  "y": 48
                },
                {
                  "x": 219,
                  "y": 125
                },
                {
                  "x": 168,
                  "y": 127
                }
              ],
              "content": "하"
            },
            {
              "center_point": {
                "x": 254,
                "y": 82
              },
              "coord": [
                {
                  "x": 217,
                  "y": 48
                },
                {
                  "x": 288,
                  "y": 45
                },
                {
                  "x": 292,
                  "y": 122
                },
                {
                  "x": 220,
                  "y": 125
                }
              ],
              "content": "나"
            },
            {
              "center_point": {
                "x": 327,
                "y": 82
              },
              "coord": [
                {
                  "x": 289,
                  "y": 45
                },
                {
                  "x": 361,
                  "y": 42
                },
                {
                  "x": 365,
                  "y": 119
                },
                {
                  "x": 293,
                  "y": 122
                }
              ],
              "content": "때"
            },
            {
              "center_point": {
                "x": 379,
                "y": 80
              },
              "coord": [
                {
                  "x": 362,
                  "y": 42
                },
                {
                  "x": 392,
                  "y": 41
                },
                {
                  "x": 396,
                  "y": 118
                },
                {
                  "x": 366,
                  "y": 119
                }
              ],
              "content": "문"
            },
            {
              "center_point": {
                "x": 431,
                "y": 77
              },
              "coord": [
                {
                  "x": 393,
                  "y": 40
                },
                {
                  "x": 465,
                  "y": 37
                },
                {
                  "x": 469,
                  "y": 115
                },
                {
                  "x": 397,
                  "y": 118
                }
              ],
              "content": "에"
            },
            {
              "center_point": {
                "x": 493,
                "y": 74
              },
              "coord": [
                {
                  "x": 466,
                  "y": 37
                },
                {
                  "x": 517,
                  "y": 35
                },
                {
                  "x": 521,
                  "y": 112
                },
                {
                  "x": 470,
                  "y": 115
                }
              ],
              "content": "망"
            },
            {
              "center_point": {
                "x": 545,
                "y": 71
              },
              "coord": [
                {
                  "x": 518,
                  "y": 35
                },
                {
                  "x": 569,
                  "y": 33
                },
                {
                  "x": 573,
                  "y": 110
                },
                {
                  "x": 522,
                  "y": 112
                }
              ],
              "content": "진"
            },
            {
              "center_point": {
                "x": 595,
                "y": 69
              },
              "coord": [
                {
                  "x": 570,
                  "y": 33
                },
                {
                  "x": 616,
                  "y": 31
                },
                {
                  "x": 620,
                  "y": 108
                },
                {
                  "x": 574,
                  "y": 110
                }
              ],
              "content": "몸"
            }
          ]
        },
        {
          "exception": 0,
          "coord": [
            {
              "x": 110,
              "y": 122
            },
            {
              "x": 607,
              "y": 112
            },
            {
              "x": 609,
              "y": 193
            },
            {
              "x": 111,
              "y": 204
            }
          ],
          "words": [
            {
              "coord": [
                {
                  "x": 109,
                  "y": 122
                },
                {
                  "x": 277,
                  "y": 118
                },
                {
                  "x": 279,
                  "y": 201
                },
                {
                  "x": 111,
                  "y": 204
                }
              ],
              "content": "사라진"
            },
            {
              "coord": [
                {
                  "x": 278,
                  "y": 118
                },
                {
                  "x": 359,
                  "y": 116
                },
                {
                  "x": 361,
                  "y": 199
                },
                {
                  "x": 280,
                  "y": 201
                }
              ],
              "content": "꿈"
            },
            {
              "coord": [
                {
                  "x": 360,
                  "y": 116
                },
                {
                  "x": 523,
                  "y": 113
                },
                {
                  "x": 524,
                  "y": 196
                },
                {
                  "x": 362,
                  "y": 199
                }
              ],
              "content": "불하는"
            },
            {
              "coord": [
                {
                  "x": 524,
                  "y": 113
                },
                {
                  "x": 606,
                  "y": 111
                },
                {
                  "x": 607,
                  "y": 194
                },
                {
                  "x": 525,
                  "y": 196
                }
              ],
              "content": "맘"
            }
          ],
          "angle": 1.17599452,
          "conf": 0,
          "word_units": [
            {
              "center_point": {
                "x": 147,
                "y": 165
              },
              "coord": [
                {
                  "x": 109,
                  "y": 122
                },
                {
                  "x": 184,
                  "y": 120
                },
                {
                  "x": 186,
                  "y": 203
                },
                {
                  "x": 111,
                  "y": 204
                }
              ],
              "content": "사"
            },
            {
              "center_point": {
                "x": 213,
                "y": 164
              },
              "coord": [
                {
                  "x": 185,
                  "y": 120
                },
                {
                  "x": 239,
                  "y": 119
                },
                {
                  "x": 241,
                  "y": 201
                },
                {
                  "x": 187,
                  "y": 203
                }
              ],
              "content": "라"
            },
            {
              "center_point": {
                "x": 278,
                "y": 161
              },
              "coord": [
                {
                  "x": 240,
                  "y": 119
                },
                {
                  "x": 315,
                  "y": 117
                },
                {
                  "x": 317,
                  "y": 200
                },
                {
                  "x": 242,
                  "y": 201
                }
              ],
              "content": "진"
            },
            {
              "center_point": {
                "x": 360,
                "y": 156
              },
              "coord": [
                {
                  "x": 316,
                  "y": 117
                },
                {
                  "x": 403,
                  "y": 116
                },
                {
                  "x": 405,
                  "y": 198
                },
                {
                  "x": 318,
                  "y": 200
                }
              ],
              "content": "꿈"
            },
            {
              "center_point": {
                "x": 426,
                "y": 153
              },
              "coord": [
                {
                  "x": 404,
                  "y": 116
                },
                {
                  "x": 446,
                  "y": 115
                },
                {
                  "x": 448,
                  "y": 197
                },
                {
                  "x": 406,
                  "y": 198
                }
              ],
              "content": "불"
            },
            {
              "center_point": {
                "x": 469,
                "y": 156
              },
              "coord": [
                {
                  "x": 447,
                  "y": 115
                },
                {
                  "x": 490,
                  "y": 114
                },
                {
                  "x": 491,
                  "y": 196
                },
                {
                  "x": 449,
                  "y": 197
                }
              ],
              "content": "하"
            },
            {
              "center_point": {
                "x": 524,
                "y": 154
              },
              "coord": [
                {
                  "x": 491,
                  "y": 114
                },
                {
                  "x": 556,
                  "y": 112
                },
                {
                  "x": 557,
                  "y": 195
                },
                {
                  "x": 492,
                  "y": 196
                }
              ],
              "content": "는"
            },
            {
              "center_point": {
                "x": 581,
                "y": 148
              },
              "coord": [
                {
                  "x": 557,
                  "y": 112
                },
                {
                  "x": 606,
                  "y": 111
                },
                {
                  "x": 607,
                  "y": 194
                },
                {
                  "x": 558,
                  "y": 195
                }
              ],
              "content": "맘"
            }
          ]
        },
        {
          "exception": 0,
          "coord": [
            {
              "x": 116,
              "y": 208
            },
            {
              "x": 607,
              "y": 197
            },
            {
              "x": 609,
              "y": 264
            },
            {
              "x": 118,
              "y": 274
            }
          ],
          "words": [
            {
              "coord": [
                {
                  "x": 116,
                  "y": 207
                },
                {
                  "x": 164,
                  "y": 206
                },
                {
                  "x": 165,
                  "y": 273
                },
                {
                  "x": 117,
                  "y": 274
                }
              ],
              "content": "널"
            },
            {
              "coord": [
                {
                  "x": 165,
                  "y": 206
                },
                {
                  "x": 423,
                  "y": 201
                },
                {
                  "x": 424,
                  "y": 268
                },
                {
                  "x": 166,
                  "y": 273
                }
              ],
              "content": "위해서라면"
            },
            {
              "coord": [
                {
                  "x": 424,
                  "y": 201
                },
                {
                  "x": 606,
                  "y": 197
                },
                {
                  "x": 607,
                  "y": 264
                },
                {
                  "x": 425,
                  "y": 268
                }
              ],
              "content": "이한몸"
            }
          ],
          "angle": 1.20746052,
          "conf": 0,
          "word_units": [
            {
              "center_point": {
                "x": 156,
                "y": 236
              },
              "coord": [
                {
                  "x": 116,
                  "y": 207
                },
                {
                  "x": 196,
                  "y": 206
                },
                {
                  "x": 197,
                  "y": 273
                },
                {
                  "x": 117,
                  "y": 274
                }
              ],
              "content": "널"
            },
            {
              "center_point": {
                "x": 219,
                "y": 238
              },
              "coord": [
                {
                  "x": 197,
                  "y": 205
                },
                {
                  "x": 241,
                  "y": 205
                },
                {
                  "x": 242,
                  "y": 272
                },
                {
                  "x": 198,
                  "y": 273
                }
              ],
              "content": "위"
            },
            {
              "center_point": {
                "x": 264,
                "y": 238
              },
              "coord": [
                {
                  "x": 242,
                  "y": 205
                },
                {
                  "x": 287,
                  "y": 204
                },
                {
                  "x": 288,
                  "y": 271
                },
                {
                  "x": 243,
                  "y": 272
                }
              ],
              "content": "해"
            },
            {
              "center_point": {
                "x": 310,
                "y": 237
              },
              "coord": [
                {
                  "x": 288,
                  "y": 204
                },
                {
                  "x": 332,
                  "y": 203
                },
                {
                  "x": 333,
                  "y": 270
                },
                {
                  "x": 289,
                  "y": 271
                }
              ],
              "content": "서"
            },
            {
              "center_point": {
                "x": 359,
                "y": 234
              },
              "coord": [
                {
                  "x": 333,
                  "y": 203
                },
                {
                  "x": 386,
                  "y": 202
                },
                {
                  "x": 387,
                  "y": 269
                },
                {
                  "x": 334,
                  "y": 270
                }
              ],
              "content": "라"
            },
            {
              "center_point": {
                "x": 423,
                "y": 232
              },
              "coord": [
                {
                  "x": 387,
                  "y": 201
                },
                {
                  "x": 459,
                  "y": 200
                },
                {
                  "x": 460,
                  "y": 267
                },
                {
                  "x": 388,
                  "y": 269
                }
              ],
              "content": "면"
            },
            {
              "center_point": {
                "x": 486,
                "y": 233
              },
              "coord": [
                {
                  "x": 460,
                  "y": 200
                },
                {
                  "x": 513,
                  "y": 199
                },
                {
                  "x": 514,
                  "y": 266
                },
                {
                  "x": 461,
                  "y": 267
                }
              ],
              "content": "이"
            },
            {
              "center_point": {
                "x": 541,
                "y": 231
              },
              "coord": [
                {
                  "x": 514,
                  "y": 199
                },
                {
                  "x": 568,
                  "y": 198
                },
                {
                  "x": 569,
                  "y": 265
                },
                {
                  "x": 515,
                  "y": 266
                }
              ],
              "content": "한"
            },
            {
              "center_point": {
                "x": 587,
                "y": 228
              },
              "coord": [
                {
                  "x": 569,
                  "y": 198
                },
                {
                  "x": 606,
                  "y": 197
                },
                {
                  "x": 607,
                  "y": 264
                },
                {
                  "x": 570,
                  "y": 265
                }
              ],
              "content": "몸"
            }
          ]
        },
        {
          "exception": 0,
          "coord": [
            {
              "x": 85,
              "y": 269
            },
            {
              "x": 660,
              "y": 268
            },
            {
              "x": 660,
              "y": 337
            },
            {
              "x": 85,
              "y": 338
            }
          ],
          "words": [
            {
              "coord": [
                {
                  "x": 85,
                  "y": 268
                },
                {
                  "x": 181,
                  "y": 268
                },
                {
                  "x": 182,
                  "y": 338
                },
                {
                  "x": 86,
                  "y": 338
                }
              ],
              "content": "날려"
            },
            {
              "coord": [
                {
                  "x": 182,
                  "y": 268
                },
                {
                  "x": 251,
                  "y": 268
                },
                {
                  "x": 252,
                  "y": 338
                },
                {
                  "x": 183,
                  "y": 338
                }
              ],
              "content": "니"
            },
            {
              "coord": [
                {
                  "x": 252,
                  "y": 268
                },
                {
                  "x": 363,
                  "y": 268
                },
                {
                  "x": 364,
                  "y": 338
                },
                {
                  "x": 253,
                  "y": 338
                }
              ],
              "content": "있는"
            },
            {
              "coord": [
                {
                  "x": 364,
                  "y": 268
                },
                {
                  "x": 513,
                  "y": 268
                },
                {
                  "x": 514,
                  "y": 338
                },
                {
                  "x": 365,
                  "y": 338
                }
              ],
              "content": "곳이면"
            },
            {
              "coord": [
                {
                  "x": 514,
                  "y": 268
                },
                {
                  "x": 658,
                  "y": 268
                },
                {
                  "x": 660,
                  "y": 337
                },
                {
                  "x": 515,
                  "y": 338
                }
              ],
              "content": "달라"
            }
          ],
          "angle": 0.128465652,
          "conf": 0,
          "word_units": [
            {
              "center_point": {
                "x": 116,
                "y": 304
              },
              "coord": [
                {
                  "x": 85,
                  "y": 268
                },
                {
                  "x": 149,
                  "y": 268
                },
                {
                  "x": 150,
                  "y": 338
                },
                {
                  "x": 86,
                  "y": 338
                }
              ],
              "content": "날"
            },
            {
              "center_point": {
                "x": 182,
                "y": 304
              },
              "coord": [
                {
                  "x": 150,
                  "y": 268
                },
                {
                  "x": 214,
                  "y": 268
                },
                {
                  "x": 215,
                  "y": 338
                },
                {
                  "x": 151,
                  "y": 338
                }
              ],
              "content": "려"
            },
            {
              "center_point": {
                "x": 251,
                "y": 304
              },
              "coord": [
                {
                  "x": 215,
                  "y": 268
                },
                {
                  "x": 289,
                  "y": 268
                },
                {
                  "x": 290,
                  "y": 338
                },
                {
                  "x": 216,
                  "y": 338
                }
              ],
              "content": "니"
            },
            {
              "center_point": {
                "x": 312,
                "y": 302
              },
              "coord": [
                {
                  "x": 290,
                  "y": 268
                },
                {
                  "x": 335,
                  "y": 268
                },
                {
                  "x": 336,
                  "y": 338
                },
                {
                  "x": 291,
                  "y": 338
                }
              ],
              "content": "있"
            },
            {
              "center_point": {
                "x": 363,
                "y": 302
              },
              "coord": [
                {
                  "x": 336,
                  "y": 268
                },
                {
                  "x": 391,
                  "y": 268
                },
                {
                  "x": 392,
                  "y": 338
                },
                {
                  "x": 337,
                  "y": 338
                }
              ],
              "content": "는"
            },
            {
              "center_point": {
                "x": 410,
                "y": 305
              },
              "coord": [
                {
                  "x": 392,
                  "y": 268
                },
                {
                  "x": 429,
                  "y": 268
                },
                {
                  "x": 430,
                  "y": 338
                },
                {
                  "x": 393,
                  "y": 338
                }
              ],
              "content": "곳"
            },
            {
              "center_point": {
                "x": 448,
                "y": 303
              },
              "coord": [
                {
                  "x": 430,
                  "y": 268
                },
                {
                  "x": 466,
                  "y": 268
                },
                {
                  "x": 467,
                  "y": 338
                },
                {
                  "x": 431,
                  "y": 338
                }
              ],
              "content": "이"
            },
            {
              "center_point": {
                "x": 508,
                "y": 301
              },
              "coord": [
                {
                  "x": 467,
                  "y": 268
                },
                {
                  "x": 550,
                  "y": 268
                },
                {
                  "x": 551,
                  "y": 338
                },
                {
                  "x": 468,
                  "y": 338
                }
              ],
              "content": "면"
            },
            {
              "center_point": {
                "x": 574,
                "y": 301
              },
              "coord": [
                {
                  "x": 551,
                  "y": 268
                },
                {
                  "x": 597,
                  "y": 268
                },
                {
                  "x": 598,
                  "y": 338
                },
                {
                  "x": 552,
                  "y": 338
                }
              ],
              "content": "달"
            },
            {
              "center_point": {
                "x": 628,
                "y": 302
              },
              "coord": [
                {
                  "x": 598,
                  "y": 268
                },
                {
                  "x": 658,
                  "y": 268
                },
                {
                  "x": 660,
                  "y": 337
                },
                {
                  "x": 599,
                  "y": 338
                }
              ],
              "content": "라"
            }
          ]
        }
      ],
      "height": 339
    }
  ],
  "category": "mix0",
  "version": "3.5.0.2089"
}
错误码
备注:如出现下述列表中没有的错误码,可到 这里 查询。
| 错误码 | 错误描述 | 说明 | 处理策略 | 
|---|---|---|---|
| 10009 | input invalid data | 输入数据非法 | 检查输入数据 | 
| 10010 | service license not enough | 没有授权许可或授权数已满 | 请到控制台提交工单联系技术人员 | 
| 10019 | service read buffer timeout, session timeout | session超时 | 检查是否数据发送完毕但未关闭连接 | 
| 10139 | invalid param | 参数错误 | 检查参数是否正确 | 
| 10160 | parse request json error | 请求数据格式非法 | 检查请求数据是否是合法的json | 
| 10161 | parse base64 string error | base64解码失败 | 检查发送的数据是否使用base64编码了 | 
| 10163 | param validate error:... | 参数校验失败 | 具体原因见详细的描述 | 
| 10223 | RemoteLB: can't find valued addr | lb 找不到节点 | 请到控制台提交工单联系技术人员 | 
| 10313 | invalid appid | appid和apikey不匹配 | 检查appid是否合法 | 
调用示例
注: 其他开发语言请参照 接口调用流程 进行开发,也欢迎热心的开发者到 讯飞开放平台社区 分享你们的demo。
常见问题
印刷文字识别(多语种)的主要功能是什么?
答:将图片(来源如扫描仪或数码相机)中的字体转化为计算机可编码的文字,支持中文、英文、日语、韩语、俄语。
印刷文字识别(多语种)支持什么应用平台?
答:目前支持Web API应用平台。
印刷文字识别(多语种)对图片有什么要求吗?
答:图片格式支持jpg格式/jpeg格式/png格式/bmp格式,且需保证图像文件大小base64编码后不超过4MB