本文档介绍通用识别RecognizeCharacter的语法及示例。

功能描述

RecognizeCharacter可以识别图像中文字内容和文字区域坐标,适用于多场景图像文字识别。

前提条件

请确保您已开通文字识别服务,详情请参见服务开通

输入限制

  • 请求格式:JPEG、JPG、PNG、BMP、GIF。
  • 图像大小:图像大小不超过3M。
  • 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeCharacter

要执行的操作。取值:RecognizeCharacter。

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/demo-center/ocr/RecognizeCharacter.jpg

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

MinHeight Integer 10

图片中文字的最小高度,单位像素。

OutputProbability Boolean true

是否输出文字框的概率。取值true或者false。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Results Array

返回识别信息。

Probability Float 0.99908673763275146

文字内容的概率,取值范围为0~1。

Text String 6月9日

文字内容。

TextRectangles Struct

文字框区域位置。

Angle Integer -89

文字区域角度,角度范围[-180, 180]

Height Integer 58

文字区域高度。

Left Integer 126

文字区域左上角x坐标。

Top Integer 26

文字区域左上角y坐标。

Width Integer 17

文字区域宽度。

RequestId String 062A6BA0-40AF-47D4-B2A3-664B1009141F

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizeCharacter
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/demo-center/ocr/RecognizeCharacter.jpg
&MinHeight=10
&OutputProbability=true
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>062A6BA0-40AF-47D4-B2A3-664B1009141F</RequestId>
<Data>
    <Results>
        <TextRectangles>
            <Left>126</Left>
            <Angle>-89</Angle>
            <Top>26</Top>
            <Height>58</Height>
            <Width>17</Width>
        </TextRectangles>
        <Probability>0.99908673763275146</Probability>
        <Text>6月9日</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>124</Left>
            <Angle>-89</Angle>
            <Top>-22</Top>
            <Height>198</Height>
            <Width>19</Width>
        </TextRectangles>
        <Probability>0.7280038595199585</Probability>
        <Text>名企商机干亿市场发布会</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>129</Left>
            <Angle>-89</Angle>
            <Top>77</Top>
            <Height>61</Height>
            <Width>15</Width>
        </TextRectangles>
        <Probability>0.99313169717788696</Probability>
        <Text>邀请函</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>72</Left>
            <Angle>-89</Angle>
            <Top>102</Top>
            <Height>86</Height>
            <Width>10</Width>
        </TextRectangles>
        <Probability>0.72483104467391968</Probability>
        <Text>尊敬的先生/女士嘉宾</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>57</Left>
            <Angle>-89</Angle>
            <Top>147</Top>
            <Height>22</Height>
            <Width>9</Width>
        </TextRectangles>
        <Probability>0.62350982427597046</Probability>
        <Text>您好!</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>34</Left>
            <Angle>0</Angle>
            <Top>167</Top>
            <Height>9</Height>
            <Width>204</Width>
        </TextRectangles>
        <Probability>0.32332202792167664</Probability>
        <Text>现诚邀请您在临“6月9日名企商机千亿市场发布会</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>35</Left>
            <Angle>0</Angle>
            <Top>206</Top>
            <Height>14</Height>
            <Width>113</Width>
        </TextRectangles>
        <Probability>0.7724418044090271</Probability>
        <Text>01新采购新趋势</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>69</Left>
            <Angle>-89</Angle>
            <Top>188</Top>
            <Height>76</Height>
            <Width>7</Width>
        </TextRectangles>
        <Probability>0.19863292574882507</Probability>
        <Text>*IW PURCHASE 1 1***</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>35</Left>
            <Angle>0</Angle>
            <Top>243</Top>
            <Height>14</Height>
            <Width>154</Width>
        </TextRectangles>
        <Probability>0.82449477910995483</Probability>
        <Text>02采购供应链+两化融合</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>34</Left>
            <Angle>0</Angle>
            <Top>259</Top>
            <Height>7</Height>
            <Width>133</Width>
        </TextRectangles>
        <Probability>0.23317055404186249</Probability>
        <Text>PEDCORENERT SUPPLY CEAIR TWO FOSIO</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>90</Left>
            <Angle>-89</Angle>
            <Top>223</Top>
            <Height>125</Height>
            <Width>14</Width>
        </TextRectangles>
        <Probability>0.72289299964904785</Probability>
        <Text>03阳光效益转型</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>115</Left>
            <Angle>-89</Angle>
            <Top>236</Top>
            <Height>202</Height>
            <Width>10</Width>
        </TextRectangles>
        <Probability>0.72888237237930298</Probability>
        <Text>主办单位:网里巴巴(中国)网络技术有限公司</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>90</Left>
            <Angle>-89</Angle>
            <Top>290</Top>
            <Height>121</Height>
            <Width>9</Width>
        </TextRectangles>
        <Probability>0.48480159044265747</Probability>
        <Text>主办部门:大企业采购+诚信通</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>72</Left>
            <Angle>-89</Angle>
            <Top>320</Top>
            <Height>85</Height>
            <Width>10</Width>
        </TextRectangles>
        <Probability>0.99824750423431396</Probability>
        <Text>时间:2017年6月9日</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>115</Left>
            <Angle>-89</Angle>
            <Top>285</Top>
            <Height>182</Height>
            <Width>9</Width>
        </TextRectangles>
        <Probability>0.87808668613433838</Probability>
        <Text>地址:中国浙江省杭州市滨江区网商路699号</Text>
    </Results>
    <Results>
        <TextRectangles>
            <Left>65</Left>
            <Angle>-89</Angle>
            <Top>353</Top>
            <Height>72</Height>
            <Width>10</Width>
        </TextRectangles>
        <Probability>0.77262163162231445</Probability>
        <Text>阿里巴巴集团总部</Text>
    </Results>
</Data>

JSON 格式

{
	"RequestId": "062A6BA0-40AF-47D4-B2A3-664B1009141F",
	"Data": {
		"Results": [
			{
				"TextRectangles": {
					"Left": 126,
					"Angle": -89,
					"Top": 26,
					"Height": 58,
					"Width": 17
				},
				"Probability": "0.99908673763275146",
				"Text": "6月9日"
			},
			{
				"TextRectangles": {
					"Left": 124,
					"Angle": -89,
					"Top": -22,
					"Height": 198,
					"Width": 19
				},
				"Probability": "0.7280038595199585",
				"Text": "名企商机干亿市场发布会"
			},
			{
				"TextRectangles": {
					"Left": 129,
					"Angle": -89,
					"Top": 77,
					"Height": 61,
					"Width": 15
				},
				"Probability": "0.99313169717788696",
				"Text": "邀请函"
			},
			{
				"TextRectangles": {
					"Left": 72,
					"Angle": -89,
					"Top": 102,
					"Height": 86,
					"Width": 10
				},
				"Probability": "0.72483104467391968",
				"Text": "尊敬的先生/女士嘉宾"
			},
			{
				"TextRectangles": {
					"Left": 57,
					"Angle": -89,
					"Top": 147,
					"Height": 22,
					"Width": 9
				},
				"Probability": "0.62350982427597046",
				"Text": "您好!"
			},
			{
				"TextRectangles": {
					"Left": 34,
					"Angle": 0,
					"Top": 167,
					"Height": 9,
					"Width": 204
				},
				"Probability": "0.32332202792167664",
				"Text": "现诚邀请您在临“6月9日名企商机千亿市场发布会"
			},
			{
				"TextRectangles": {
					"Left": 35,
					"Angle": 0,
					"Top": 206,
					"Height": 14,
					"Width": 113
				},
				"Probability": "0.7724418044090271",
				"Text": "01新采购新趋势"
			},
			{
				"TextRectangles": {
					"Left": 69,
					"Angle": -89,
					"Top": 188,
					"Height": 76,
					"Width": 7
				},
				"Probability": "0.19863292574882507",
				"Text": "*IW PURCHASE 1 1***"
			},
			{
				"TextRectangles": {
					"Left": 35,
					"Angle": 0,
					"Top": 243,
					"Height": 14,
					"Width": 154
				},
				"Probability": "0.82449477910995483",
				"Text": "02采购供应链+两化融合"
			},
			{
				"TextRectangles": {
					"Left": 34,
					"Angle": 0,
					"Top": 259,
					"Height": 7,
					"Width": 133
				},
				"Probability": "0.23317055404186249",
				"Text": "PEDCORENERT SUPPLY CEAIR TWO FOSIO"
			},
			{
				"TextRectangles": {
					"Left": 90,
					"Angle": -89,
					"Top": 223,
					"Height": 125,
					"Width": 14
				},
				"Probability": "0.72289299964904785",
				"Text": "03阳光效益转型"
			},
			{
				"TextRectangles": {
					"Left": 115,
					"Angle": -89,
					"Top": 236,
					"Height": 202,
					"Width": 10
				},
				"Probability": "0.72888237237930298",
				"Text": "主办单位:网里巴巴(中国)网络技术有限公司"
			},
			{
				"TextRectangles": {
					"Left": 90,
					"Angle": -89,
					"Top": 290,
					"Height": 121,
					"Width": 9
				},
				"Probability": "0.48480159044265747",
				"Text": "主办部门:大企业采购+诚信通"
			},
			{
				"TextRectangles": {
					"Left": 72,
					"Angle": -89,
					"Top": 320,
					"Height": 85,
					"Width": 10
				},
				"Probability": "0.99824750423431396",
				"Text": "时间:2017年6月9日"
			},
			{
				"TextRectangles": {
					"Left": 115,
					"Angle": -89,
					"Top": 285,
					"Height": 182,
					"Width": 9
				},
				"Probability": "0.87808668613433838",
				"Text": "地址:中国浙江省杭州市滨江区网商路699号"
			},
			{
				"TextRectangles": {
					"Left": 65,
					"Angle": -89,
					"Top": 353,
					"Height": 72,
					"Width": 10
				},
				"Probability": "0.77262163162231445",
				"Text": "阿里巴巴集团总部"
			}
		]
	}
}

错误码

关于通用识别的错误码,详情请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。