1. 接口描述
接口请求域名: ocr.tencentcloudapi.com 。
用于试题批改Agent查询任务。主要面向K12的试题批改产品,支持整卷/单题端到端(试卷切题+题目批改+手写坐标回显)处理,主要聚焦的场景包括试题批改(含手写答案)、试题解析(不含手写答案),其中低年级算式批改效果比线上数学作业批改效果更好。精准输出题目、正误判定、答案对比、错误及知识点等结构化评估结果。
默认接口请求并发限制:10题/分钟。
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:DescribeQuestionMarkAgentJob。 |
| Version | 是 | String | 公共参数,本接口取值:2018-11-19。 |
| Region | 否 | String | 公共参数,此参数为可选参数。 |
| JobId | 否 | String | 任务唯一ID。由服务端生成。 示例值:1334797167793684480 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| ErrorCode | String | 任务执行错误码。当任务状态不为 FAIL 时,该值为""。 示例值:FailedOperation.PDFParseFailed |
| ErrorMessage | String | 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。 示例值:PDF解析失败。 |
| JobStatus | String | 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功 示例值:DONE |
| Angle | Float | 图片旋转角度(角度制),文本的水平方向为 0;顺时针为正,逆时针为负。 示例值:1.0 |
| MarkInfos | Array of MarkInfo | 试题批改信息 |
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 成功示例
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeQuestionMarkAgentJob
<公共请求参数>
{
"JobId": "1410888033157898240"
}
输出示例
{
"Response": {
"Angle": 0,
"ErrorCode": "",
"ErrorMessage": "",
"JobStatus": "DONE",
"MarkInfos": [
{
"AnswerInfos": [],
"MarkInfos": [
{
"AnswerInfos": [
{
"AnswerAnalysis": "首先将除法转化为乘法,对分子分母因式分解后约分,正确计算过程为$\\frac{2}{a-1}\\div\\frac{2a-4}{a^2-1}=\\frac{2}{a-1}\times\\frac{(a+1)(a-1)}{2(a-2)}=\\frac{a+1}{a-2}$,手写答案最后一步分母错误。",
"HandwriteInfo": "$\\frac{2}{a-1}\\div\\frac{2a-4}{a^2-1}=\\frac{2}{a-1}\times\\frac{(a+1)(a-1)}{2(a-2)}=\\frac{a+1}{a+2}$",
"HandwriteInfoPositions": [
113,
648,
558,
648,
558,
698,
113,
698
],
"IsCorrect": false,
"KnowledgePoints": [],
"RightAnswer": ""
}
],
"MarkInfos": [],
"MarkItemTitle": "(1)小琪猜测,墨水遮住的内容是“2a”,请你根据小琪的猜测完成计算;"
},
{
"AnswerInfos": [
{
"AnswerAnalysis": "设被墨水遮住的部分为A,根据题意$\\frac{2}{a-1}\\div\\frac{A-4}{a^2-1}=\\frac{1}{a-2}$,先将除法转化为乘法,得到$\\frac{2}{a-1}\times\\frac{(a+1)(a-1)}{A-4}=\\frac{1}{a-2}$,化简后求解A,正确过程为:$\\frac{2(a+1)}{A-4}=\\frac{1}{a-2}$,交叉相乘得$A-4=2(a+1)(a-2)=2(a^2-a-2)=2a^2-2a-4$,所以$A=2a^2-2a$,手写答案计算错误,没有正确求出被遮住的二次二项式。",
"HandwriteInfo": "$\\frac{2}{a-1}\\div\\frac{1}{a-2}=\\frac{2(a-2)}{a-1}=\\frac{2(a-2)(a+1)}{a^2-1}=\\frac{2a^2-2a-2}{a^2-1}$",
"HandwriteInfoPositions": [
164,
698,
450,
698,
450,
855,
164,
855
],
"IsCorrect": false,
"KnowledgePoints": [],
"RightAnswer": ""
}
],
"MarkInfos": [],
"MarkItemTitle": "(2)第二天,小琪的同桌告诉她,这道题被墨水遮住的是一个二次二项式,并且这道题的标准答案是$\\frac{1}{a-2}$,请你通过计算说明墨水遮住的内容是什么."
}
],
"MarkItemTitle": "1. 小琪在做作业时发现有一道题的一部分被墨水遮住了,如图所示。计算: $\\frac{2}{a-1}\\div\\frac{▄-4}{a^2-1}$."
},
{
"AnswerInfos": [],
"MarkInfos": [
{
"AnswerInfos": [
{
"AnswerAnalysis": "先根据垂直的性质得到∠A=∠B=90°,再结合运动速度和时间算出AP、BQ、BP的长度,得到BP=AC,然后利用SAS证明△ACP≅△BPQ,最后利用全等三角形的性质和直角三角形的两个锐角互余,推出∠CPQ=90°,从而得到PC⊥PQ。",
"HandwriteInfo": "全等,PC⊥PQ。∵AC⊥AB,BD⊥AB ∴∠A=∠B=90°。∵AP=BQ=2 ∴BP=5 ∴BP=AC。在△ACP和△BPQ中,{AP=BQ,∠A=∠B,AC=BP ∴△ACP≅△BPQ(SAS)。∴∠C=∠BPQ。∵∠C+∠APC=90° ∴∠BPQ+∠APC=90°。∴PC⊥PQ。",
"HandwriteInfoPositions": [
595,
440,
905,
440,
905,
847,
595,
847
],
"IsCorrect": true,
"KnowledgePoints": [],
"RightAnswer": ""
}
],
"MarkInfos": [],
"MarkItemTitle": "(1)若点Q的运动速度与点P的运动速度相等,当t=1时,判断△ACP与△BPQ是否全等,并判断此时线段PC和线段PQ的位置关系,请分别说明理由."
},
{
"AnswerInfos": [
{
"AnswerAnalysis": "本题需要分两种情况讨论△ACP与△BPQ全等的情况:情况一:△ACP≅△BPQ,此时AC=BP,AP=BQ;情况二:△ACP≅△BQP,此时AC=BQ,AP=BP。学生只考虑了其中一种情况,答案不完整。",
"HandwriteInfo": "若△ACP≅△BPA,则AC=BP,AP=BQ,即{5=7-2t,2t=xt,解得{x=2,t=1。当x=2时,△ACP与△BPQ全等。",
"HandwriteInfoPositions": [
595,
440,
905,
440,
905,
847,
595,
847
],
"IsCorrect": false,
"KnowledgePoints": [],
"RightAnswer": ""
}
],
"MarkInfos": [],
"MarkItemTitle": "(2)如图②,若将“AC⊥AB,BD⊥AB”改为“∠CAB=∠DBA”,点Q的运动速度为xcm/s,其他条件不变,当x的值为多少时,△ACP与△BPQ全等?"
}
],
"MarkItemTitle": "如图①,AB=7cm,AC⊥AB,BD⊥AB,垂足分别为A,B,AC=5cm.点P在线段AB上以2cm/s的速度由点A向点B运动,同时点Q在射线BD上运动,它们运动的时间为ts(当点P运动结束时,点Q运动随之结束)."
},
{
"AnswerInfos": [],
"MarkInfos": [],
"MarkItemTitle": "单题跨页题型,完整题目批改内容已经显示在上一题"
},
{
"AnswerInfos": [
{
"AnswerAnalysis": "通过证明Rt△BOF和Rt△COE全等,得到∠FBO=∠ECO,再结合OB=OC推出∠OBC=∠OCB,进而得到∠ABC=∠ACB,最后根据等角对等边证明AB=AC,整个证明过程逻辑严谨,步骤正确。",
"HandwriteInfo": "证:在Rt△BOF和Rt△COE中\n{OF=OE\nOB=OC.\n∴Rt△BOF≅Rt△COE\n∴∠FBO=∠ECO\n∵OB=OC\n∴∠OBC=∠OCB\n∴∠FBO+∠OBC=∠ECO+∠OCB即∠ABC=∠ACB\n∴AB=AC .",
"HandwriteInfoPositions": [
595,
934,
1003,
934,
1003,
1282,
595,
1282
],
"IsCorrect": true,
"KnowledgePoints": [],
"RightAnswer": ""
}
],
"MarkInfos": [],
"MarkItemTitle": "3. 如图,△ABC内部一点O到两边AB,AC所在直线的距离相等,且OB=OC.求证:AB=AC."
}
],
"RequestId": "5c0fb341-3122-409e-ba5d-12f888397057"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.DownLoadError | 文件下载失败。 |
| FailedOperation.ImageDecodeFailed | 图片解码失败。 |
| FailedOperation.ImageSizeTooLarge | 图片尺寸过大,请参考输入参数中关于图片大小限制的说明。 |
| FailedOperation.OcrFailed | OCR识别失败。 |
| FailedOperation.PDFParseFailed | PDF解析失败。 |
| FailedOperation.UnKnowError | 未知错误。 |
| FailedOperation.UnKnowFileTypeError | 未知的文件类型。 |
| FailedOperation.UnOpenError | 服务未开通。 |
| InvalidParameterValue.InvalidParameterValueLimit | 参数值错误。 |
| LimitExceeded.TooLargeFileError | 文件内容太大。 |
| ResourceUnavailable.InArrears | 账号已欠费。 |
| ResourceUnavailable.ResourcePackageRunOut | 账号资源包耗尽。 |
| ResourcesSoldOut.ChargeStatusException | 计费状态异常。 |