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

功能描述

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

前提条件

请确保您已开通文字识别服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP、GIF。
  • 图像大小:不超过3 MB。
  • 图像分辨率:大于15×15像素,小于4096×4096像素。
  • 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:不输出文字框的概率。

返回数据

名称 类型 示例值 描述
RequestId String 062A6BA0-40AF-47D4-B2A3-664B1009141F

请求ID。

Data Object

返回的结果数据内容。

Results Array of Result

返回识别信息。

TextRectangles Object

文字框区域位置。

Top Integer 26

文字区域左上角y坐标。

Width Integer 17

文字区域宽度。

Height Integer 58

文字区域高度。

Angle Integer -89

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

说明 以文字区域中心点为旋转点,向右旋转角度为正,向左旋转角度为负。
Left Integer 126

文字区域左上角x坐标。

Text String 6月9日

文字内容。

Probability Float 0.99908673763275146

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

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。