提交与创建作文识别任务
针对手写场景专项优化，支持拼音识别，过滤涂改痕迹与无关杂项，兼容单页 / 多页 / 分栏版式，自动过滤阴影、倾斜、涂抹等干扰，输出字、行、段落、标题的文本与精准坐标信息，直接对接后续批改、排版渲染、智能分析等下游应用。 手写作文识别（多模态）API服务为异步接口，需要先调用提交请求接口获取 task_id，然后调用获取结果接口进行结果轮询，建议提交请求后 5～10 秒轮询。提交请求接口QPS为2，获取结果接口QPS为10。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看 认证鉴权。
请求参数
图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过10M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式 优先级： image > url > pdf_file，当image字段存在时，url字段失效
图片完整url，url长度不超过1024字节，url对应的图片base64编码后大小不超过10M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式 优先级： image > url > pdf_file，当image字段存在时，url字段失效
PDF文件，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过10M，最短边至少15px，最长边最大4096px 优先级： image > url > pdf_file，当image字段存在时，url字段失效
识别粒度，控制坐标返回，可选： • line: 行级坐标返回 • word: 行级坐标+字级别坐标返回 • none: 不返回坐标
指定PDF页码
POST /rest/2.0/ocr/v1/handwriting_composition/create_task?access_token="你的access_token值" HTTP/1.1
Host: aip.baidubce.com
Content-Type: application/json
{
"url": "https://xxx.example.com/demo.jpg",
"recognize_granularity": "line",
"pdf_file_num": "1"
}
示例代码
返回响应
唯一的log id，用于问题定位
错误码
错误描述信息
返回的结果列表
显示子属性
隐藏子属性
该请求生成的task_id，后续使用该task_id获取识别结果
{
"error_code": 0,
"error_msg": "success",
"result": {
"task_id": "2092810987404183567",
"status": "Success",
"created_time": 1787799997000,
"started_time": 1787799996998,
"finished_time": 1787800000305,
"duration": 3307,
"result": {
"img_dir": "0",
"layout": {
"boxes": []
},
"recognize_granularity": "word",
"grade": "",
"name": "",
"ids": "",
"essayOverall": {
"titleText": "《我的小天地》",
"contentText": "xxx"
},
"title": {},
"content": {
"lines": [],
"paragraphs": []
}
}
},
"log_id": "2092811061303471252"
}
错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码：查看专有错误码
评价此篇文章