[AI10]生成OCR识别任务的接口地址是什么？

[AI10]生成OCR识别任务的接口为 POST https://stage-connect.zhihuiya.com/ai/ocr/task/create。

在哪里可以找到 [AI10]生成OCR识别任务的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1ai~1ocr~1task~1create/post，也可在 /openapi.json 浏览完整规范。

[AI10]生成OCR识别任务

Q: [AI10]生成OCR识别任务 的接口地址是什么？

[AI10]生成OCR识别任务 的接口为 POST https://stage-connect.zhihuiya.com/ai/ocr/task/create。

Q: [AI10]生成OCR识别任务 可以返回哪些数据？

[AI10]生成OCR识别任务：该接口提供对OCR识别创建下载任务，生成job_id，通过job_id 去 [AI10]查询导出OCR识别结果。 OCR识别支持识别图片或扫描的PDF等文件中的数字、文字信息、表格内容等，且能对版面进行分析，输出跟原文档结构高度接近的多种格式的OCR识别结果。。完整响应结构请参见本页的响应结构与成功响应示例。

post

https://stage-connect.zhihuiya.com/ai/ocr/task/create

在体验中心中试用

该接口提供对OCR识别创建下载任务，生成job_id，通过job_id 去 [AI10]查询导出OCR识别结果。 OCR识别支持识别图片或扫描的PDF等文件中的数字、文字信息、表格内容等，且能对版面进行分析，输出跟原文档结构高度接近的多种格式的OCR识别结果。

1、OCR的文件文字语言默认中英文和数字； 2、OCR识别结果支持doc/html/xls/ppt/txt版本下载； 3、OCR识别结果均实时下载，多页文档OCR识别结果下载时间为1~2小时

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`document` 必填	`string`	`https://static-open.zhihuiya.com/sample/common_demo.png`	需要进行OCR识别的图片或者扫描的PDF等文件
`document_type` 必填	`string`	`png`	需要进行OCR识别的文件的类型，包括：pdf，png，jpg
`ocr_format` 必填	`string`	`doc`	查询OCR识别结果的文件格式doc/html/xls/ppt/txt
`document_lang`	`array`	`[ "简体中文", "数字", "英语" ]`	需要进行OCR识别的文件中文字的语言，可支持多选，例如：简体中文阿布哈兹语阿迪格语南非荷兰语阿古尔语阿尔巴尼亚语阿尔泰语阿拉伯语（沙特阿拉伯）亚美尼亚语（东部）亚美尼亚语（西部）亚美尼亚语（格拉巴）阿瓦尔语艾玛拉语阿塞语（西里尔）阿塞语（拉丁）巴什基尔语巴斯克语白俄罗斯语本巴语布莱克福特语布列塔尼语布哥图语保加利亚语布里亚特语加泰隆语宿务语查莫罗语车臣语繁体中文楚克其语楚瓦什语科西嘉语克里米亚鞑靼语克罗地亚语克罗语捷克语达科他语丹麦语达尔格瓦语东干语荷兰语荷兰语（比利时）英语爱斯基摩语（西里尔）爱斯基摩语（拉丁）爱沙尼亚语鄂温语鄂温克语法罗语斐济语芬兰语法语弗里西亚语弗留利语加告兹语加利西亚语干达语德语德语（卢森堡）德语（新的拼写规则）希腊语瓜拉尼语哈尼语豪萨语夏威夷语希伯来语匈牙利语冰岛语印度尼西亚语印古什语爱尔兰语意大利语日语日语（现代）景颇语卡巴尔达语卡尔梅克语恰伊-巴尔卡尔语卡拉卡尔帕克语卡舒比语卡瓦语哈萨克语哈卡斯语汉特语吉库犹语吉尔吉斯语刚果语韩语韩语（韩文字母）科尔雅克语克佩勒语库梅克语库尔德语拉克语拉丁语拉脱维亚语拉脱维亚哥特式莱兹吉语立陶宛语卢巴语马其顿语马达加斯加语马来语（马来西亚）马林凯语马耳他语曼西语毛利语马里语玛雅语苗语米南卡堡语莫霍克语蒙古语摩尔多瓦语那瓦特语涅涅茨语尼夫赫语诺盖语挪威语挪威语（博克马尔）挪威语（尼诺斯克）尼昂加语奥克语奥杰布瓦语古英语古法语古德语古意大利语古斯拉夫语古西班牙语奥塞梯语帕皮阿门托语波兰语葡萄牙语葡萄牙语（巴西）凯楚阿语（玻利维亚）利托-罗曼诸语罗马尼亚语罗马尼亚语（摩尔瓦多）吉普赛语隆迪语俄语俄语（旧式拼写）俄语带重音标记卢旺达语萨米语（拉皮什）萨摩亚语苏格兰盖尔语塞尔库普语塞尔维亚语（西里尔）塞尔维亚语（拉丁）修纳语斯洛伐克语斯洛文尼亚语索马里语索布语索托语西班牙语巽他语斯瓦希利语斯瓦齐语瑞典语塔巴萨兰语塔加洛语塔希提语塔吉克语鞑靼语泰语托克皮辛语汤加语茨瓦纳语侗语土耳其语土库曼语（西里尔）土库曼语（拉丁）图瓦语乌德穆尔特语维吾尔语（西里尔）维吾尔语（拉丁）乌克兰语乌兹别克语（西里尔）乌兹别克语（拉丁）越南语威尔士语沃洛夫语科萨语雅库特语意第绪语萨巴特克语祖鲁语注：默认为简体中文；数字；英语

{
  "document": "https://static-open.zhihuiya.com/sample/common_demo.png",
  "ocr_format": "doc",
  "document_lang": [
    "简体中文",
    "数字",
    "英语"
  ],
  "document_type": "png"
}

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`job_id`	`string`	`b4bdae6b4a65432d91f25b5c52bdfd80`	导出OCR识别结果任务id
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "job_id": "b4bdae6b4a65432d91f25b5c52bdfd80"
  },
  "status": true,
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码	描述
`68300004`	请求参数异常!
`68300005`	查询Api失败!
`68300006`	解析基本存取错误!
`68300007`	存在错误的请求!
`68300008`	服务中断异常，请稍后再试!
`68300010`	文件不符合上传规范!

平台错误码

错误码	描述
`67200000`	API整体限流错误!
`67200001`	API整体限流错误！
`67200002`	当前调用速率过快,超过当前配置限制QPS！
`67200003`	申请token的key和secret传参不正确或者客户端已被禁用！
`67200004`	请求的接口无权限请联系我们的支持人员！
`67200005`	账户余额/调用次数不足！
`67200006`	客户端超过开通有效期！
`67200007`	当前调用超过当天配置使用额度！
`67200008`	请检查query参数中必填的apikey是否传输！
`67200009`	apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
`67200012`	请求不合法！
`67200100`	当前服务器状态正忙,请求响应超时！
`67200101`	当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码	描述
`0`	请求成功
`201`	Created
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms