功能描述

通过领先的深度学习技术，对各种表格，图片，文档、证件、面单等多种通用场景、多种语言的文字进行快速、精准的检测和识别，适用于印刷体、手写体、倾斜、折叠、旋转等场景的通用文本识别、通用文字识别。当前支持52种语言包括简体中文、繁体中文、日语、韩语、英语、法语、葡萄牙语、德语、意大利语、荷兰语、瑞典语、芬兰语、丹麦语、挪威语、匈牙利语、越南语、南非语、阿尔巴尼亚语、巴斯克语、加泰罗尼亚语、克罗地亚语、捷克语、爱沙尼亚语、冰岛语、爱尔兰语、拉丁语、拉脱维亚语、立陶宛语、马来语、波兰语、罗马尼亚语、斯洛伐克文语、斯洛文尼亚语、斯瓦希里语、土耳其语、威尔士语、马耳他语、克里奥尔语、加利西亚语、世界语、菲律宾语、印度尼西亚语、阿塞拜疆语、西班牙语、俄语、保加利亚语、马其顿语、乌克兰语、塞尔维亚语、白俄罗斯语、希腊语、亚美尼亚语。

请求URL

https://api.textin.com/robot/v1.0/api/text_recognize_3d1

HTTP请求方法

HTTP POST

请求头说明（Request Header）

请在HTTP请求中添加以下自定义Header。

header 名	值
x-ti-app-id	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id
x-ti-secret-code	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code

URL参数

参数名	数据类型	是否必填	允许的值	描述
format_whole_text	integer	否	0, 1	选填，行合并参数。1为行合并，0则不做行合并。默认为0
lang_opt	array	否	见下方说明	选填，默认支持所有语言；识别语言采用ISO 639-3语言缩写标准，语言使用逗号进行拼接，例如lang_opt=zho-s,zho-t,jpn,kor

参数 lang_opt 允许的值：

zho-t, jpn, kor, eng, fre, por, ger, ita, nla, swe, fin, dan, nor, hun, vie, afr, sqi, eus, cat, hr, cze, est, isl, iri, lat, lav, lit, msa, pol, rum, slo, slv, swa, tur, wel, mlt, ht, glg, epo, fil, ind, aze, spa, rus, bul, mak, ukr, sr, bel, gre, hye

请求体说明（Request Body）

Content-Type: application/octet-stream

要上传的图片，目前支持jpg, png, bmp, pdf, tiff, 单帧gif等大部分格式.

请注意，请求体的数据格式为文件的二进制流，非 FormData 或其他格式。文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。

响应体说明（Response Data）

Content-Type: application/json

JSON结构说明如下：

字段名	类型	描述
code	integer	错误码，详见“错误码说明”
message	string	错误信息
result	object
+rotated_image_width	integer	旋转后图片宽度
+rotated_image_height	integer	旋转后图片高度
+image_angle	integer	图片被旋转了多少度
+property_map	array	文本块属性表；background:暂不适用;text:文本
+whole_text	string	全文识别的所有内容，同行内容整合为一行输出
+lines	object	文本块识别信息集合
++text	string	文本块内容
++angle	integer	文本块被旋转了多少度
++property	integer	文本块所属属性表下标，从0开始
++position	array	文本块所属属性表下标，从0开始
++char_centers	array	字符中心坐标（每个字符中心坐标形成的集合）
++char_polygons	array	字符块坐标（每个字符左上角起，顺时针一周四角坐标形成的集合）

JSON结构示例

{
  "code": 200,
  "message": "success",
  "result": {
    "rotated_image_width": 0,
    "rotated_image_height": 0,
    "image_angle": 0,
    "property_map": [
      ""
    ],
    "whole_text": "",
    "lines": {
      "text": "",
      "angle": 0,
      "property": 0,
      "position": [
        0
      ],
      "char_centers": [
        [
          0
        ]
      ],
      "char_polygons": [
        [
          0
        ]
      ]
    }
  }
}

错误码说明

错误码	描述
40101	x-ti-app-id 或 x-ti-secret-code 为空
40102	x-ti-app-id 或 x-ti-secret-code 无效，验证失败
40003	余额不足，请充值后再使用
40004	参数错误，请查看技术文档，检查传参
40007	机器人不存在或未发布
40008	机器人未开通，请至市场开通后重试
40301	图片类型不支持
40302	上传文件大小不符，文件大小不超过 10M
40303	文件类型不支持
40304	图片尺寸不符，图像宽高须介于 20 和 10000（像素）之间
40305	识别文件未上传
30203	基础服务故障，请稍后重试
500	服务器内部错误