本文档介绍作业批改API接口的输入输出参数。调用文档中的接口可以实现作业批改功能。作业批改服务有免费的切题能力，无需额外接入切题服务。

认证方式

接口详情

作业批改任务提交接口

任务提交接口限流：火山账号维度，默认60RPM

URL

URL	ApiKey: https://open.feedcoopapi.com/agent_api/agent/home_work/mark/submit Top: https://mercury.volcengineapi.com?Action=HomeWorkMarkSubmit&Version=2026-01-01
Method	POST
Header	API Key接入： Authorization: Bearer <API_KEY> Content-Type：application/json ServiceName: ask_echo Access Key接入： Content-Type：application/json 此接入方式基于火山引擎访问控制的AK/SK鉴权，统一使用 ServiceName=ask_echo，接口验签及请求公共参数逻辑遵循火山引擎官网的统一规范，详情请参见：签名方法--API签名调用指南-火山引擎

请求体

HomeWorkMarkSubmitRequest

参数	类型	必需	描述
bot_id	String	是	智能体id，控制台创建后使用
image_base64	String	否	与image_url字段二选一，两字段都传，默认使用image_base64 图片base64，需要满足DataUrl格式data:{MIME Type};base64,{base64_image} 示例：data:image/jpeg;base64,{base64_image} 图片格式支持：JPEG、PNG、GIF、WEBP、BMP、TIFF、HEIC、HEIF（详情见图片格式说明）单张图片大小：推荐大小：<=500KB 最大限制： WebUrl传入 APIKey接入：单张图片大小<10M，超出会报参数错误 TOP网关接入：请求体整体长度不能超过8M DataUrl传入 APIKey接入：单张图片Base64编码后长度<20M，超出会报参数错误 TOP网关接入：请求体整体长度不能超过8M 单图片尺寸判断，如果图片超出下面的限制，会直接报错，传入图片满足下面条件（单位 px）：宽 > 14 且高>14 宽*高范围： [196, 36000000]
image_url	String	否	图片WebUrl，建议优先使用image_base64字段，WebUrl需要下载，可能存在下载延迟和不稳定问题字段限制与图片限制见image_base64字段描述
enable_image_dewarp	Boolean	否	是否开启图片矫正预处理，默认开启
enable_orientation_classification	Boolean	否	是否开启智能图片方向检测，默认开启
enable_cross_judge	Boolean	否	是否开启跨栏题识别，默认不开启。开启后如果图片存在跨栏题（多列题）的情况下，会在异步处理时进行跨栏题识别，预估增加最多2秒耗时，并增加额外token消耗。非跨栏题（单列题）情况不受影响

响应体

HomeWorkMarkSubmitResponse

参数	类型	必需	描述
task_id	String	是	返回唯一任务id
preprocessed_image_url	String	是	作业原始图片经过矫正后的图片地址，链接仅创建任务后7天内支持访问，如需持久化需自行转存
mark_results	HomeWorkMarkResult	否	作业切题及批改结果，如图片无题目，此字段为空

HomeWorkMarkResult

参数	类型	必需	描述
mark_id	String	是	题目id
finish	Boolean	是	当前题目是否处理完成标记位，需要finish=true时answer_results，solution，cross_question，cross_mark_id，question_type，ocr_result，figure_detection_result字段才可拿到最终处理结果
mark_points	ImagePoint	是	基于preprocessed_image_url图片的题目坐标， (x_i, y_i) (i = 0, 1, 2, 3)，(x0,y0)为切题框左上角的坐标，顺时针方向得到其余坐标
answer_results	AnswerResult	否	手写答案结果，如果finish==true时此字段为空，代表本题无手写答案。如果为跨栏题，则关联跨栏题下结果都相同
solution	string	否	题目正确答案及解析。如果为跨栏题，则关联跨栏题下结果都相同
cross_question	Boolean	否	是否跨栏题目标记，仅在开启跨栏题识别后，才可能返回true
cross_mark_id	Array<String>	否	跨栏题目关联的mark_id，如果cross_question=true，此字段有值，且包含本身mark_id
question_type	Enum(QuestionType)	否	题目分类，枚举值见下文。如果为跨栏题，则关联跨栏题下结果都相同
ocr_result	OcrResult	否	单图ocr结果。如果为跨栏题，则关联跨栏题下结果都相同
figure_detection_result	Array<FigureDetectionResult>	否	图形检测结果

ImagePoint

参数	类型	必需	描述
x	Number	是	横轴坐标
y	Number	是	纵轴坐标

AnswerResult

参数	类型	必需	描述
Id	Number	是	手写答案id
answer_points	ImagePoint	是	基于preprocessed_image_url图片的手写答案坐标， (x_i, y_i) (i = 0, 1, 2, 3)，(x0,y0)为切题框左上角的坐标，顺时针方向得到其余坐标
correct	Boolean	是	批改结果，手写答案是否正确

OcrResult

参数	类型	必需	描述
page_text	String	是	整页 OCR 文本
machine_lines	Array<OcrLineResult>	否	印刷文本逐行结果
handed_lines	Array<OcrLineResult>	否	手写文本逐行结果

OcrLineResult

参数	类型	必需	描述
line_text	String	是	每行文本内容
line_type	Enum(LineType)	是	行文本类型，枚举值见下文
line_points	Array<ImagePoint>	是	行文本坐标
score	Number	是	每行文本置信度
character_result	Array<OcrLineCharacterResult>	是	字符级识别结果

OcrLineCharacterResult

参数	类型	必需	描述
char_text	String	是	字符文本
char_type	Enum(TextCharType)	是	字符类型，枚举值见下文
char_points	Array<ImagePoint>	是	字符坐标
score	Number	是	字符置信度

FigureDetectionResult

参数	类型	必需	描述
class_name	Enum(ClassName)	是	检测类别，枚举值见下文
figure_points	Array<ImagePoint>	是	图形坐标
score	Number	是	检测置信度

请求示例

响应示例

作业批改任务查询接口

任务查询接口仅支持查询7*24h内提交任务，建议单任务查询间隔>2s

URL

URL	ApiKey: https://open.feedcoopapi.com/agent_api/agent/home_work/mark/query Top: https://mercury.volcengineapi.com?Action=HomeWorkMarkQuery&Version=2026-01-01
Method	POST
Header	API Key接入： Authorization: Bearer <API_KEY> Content-Type：application/json ServiceName: ask_echo Access Key接入： Content-Type：application/json 此接入方式基于火山引擎访问控制的AK/SK鉴权，统一使用 ServiceName=ask_echo，接口验签及请求公共参数逻辑遵循火山引擎官网的统一规范，详情请参见：签名方法--API签名调用指南-火山引擎

请求体

HomeWorkMarkQueryRequest

参数	类型	必需	描述
task_id	String	是	任务id
bot_id	String	是	智能体id，如bot_id与提交任务时传入bot_id不一致将会导致无法查询到任务

响应体

HomeWorkMarkQueryResponse

参数	类型	必需	描述
task_id	String	是	任务id
preprocessed_image_url	String	是	作业原始图片经过矫正后的图片地址，链接仅创建任务后7天内支持访问，如需持久化需自行转存
status	String	是	任务状态：running，success, failed，如status==running时，mark_results与usage可能为空或者不是最终结果
mark_results	HomeWorkMarkResult	否	作业切题及批改结果，如图片无题目，此字段为空
usage	TokenUsage	否	token消耗，如未产生消耗，则此字段为空
subject_type	Enum(SubjectType)	是	学科类型
department_type	Enum(DapartmentType)	是	学段类型
orientation	Enum(Orientation)	否	图片方向
dewarp_streangth	Number	否	图片矫正强度

HomeWorkMarkResult

与任务提交接口的HomeWorkMarkResult字段一致。

TokenUsage

参数	类型	必需	描述
prompt_tokens	Number	是	输入token消耗
completion_tokens	Number	是	输出token消耗
total_tokens	Number	是	token总消耗

枚举值

SubjectType

枚举值	说明
0	未知
1	语文
2	数学
3	英语
4	物理
5	化学
6	历史
7	地理
8	生物
9	政治
51	法律
52	健康
102	财务与会计
134	经济与金融
136	计算机科学与软件工程
141	军事与政治
142	数据科学
205	地理与交通
206	心理咨询
207	工业
208	农林牧渔

DapartmentType

枚举值	说明
0	未知
1	小学
2	初中
3	高中
4	大学
6	非 K12

QuestionType

枚举值	说明
0	未知
1	选择题
2	填空题
3	判断题
4	解答题
5	计算题
6	口算题
7	竖式计算题
8	脱式计算题
9	代数式化简题
10	解方程/解不等式
11	解方程组/解不等式组
12	其他

TextCharType

枚举值	说明
0	印刷文本
1	印刷公式
2	下划线
3	手写文本
4	手写公式
5	乱涂乱画

LineType

枚举值	说明
0	印刷文本
1	手写文本
3	印刷公式
4	手写公式

ClassName

枚举值	说明
0	其他
1	表格
2	流程图
3	化学式
4	坐标图
5	柱状图
6	数轴
7	几何图形
8	电路图
9	竖式
10	圆形/饼状图
11	背景

Orientation

枚举值	说明
0	0 度，正向
1	逆时针转 90 度
2	180 度，倒向
3	顺时针转 90 度

请求示例

响应示例

错误处理

错误响应

响应格式如下：

使用说明

图片格式说明

支持的图片格式如下表。

图片格式	文件扩展名	内容格式（Content Type）
JPEG	.jpg, .jpeg	image/jpeg
PNG	.png	image/png
GIF	.gif	image/gif
WEBP	.webp	image/webp
BMP	.bmp	image/bmp
TIFF	.tiff, .tif	image/tiff
HEIC	.heic	image/heic
HEIF	.heif	image/heif

联网问答Agent