智能作业批改

更新时间：2025-12-26

接口描述

基于多模态大模型能力，实现K12阶段的全学科作业、试卷批改。支持用户拍照或上传图片，可输出对应每道题的批改结果；支持输出数学和理综学科的解析；支持结果原图渲染，图片清晰展示题目区域和对错标识，便于快速定位问题提升批改效率。智能作业批改API服务提供以下两种调用方式：

端到端批改 ：异步接口，需要先调用提交请求接口获取 task_id ，然后调用获取结果接口进行结果轮询，建议提交请求后 5～10 秒轮询。提交请求接口QPS为2，获取结果接口QPS为2，需将请求参数only_split设置为false。

仅题目切分 ：同步接口，提交后同步返回切题结果，需将请求参数only_split设置为true。

在线调试

您可以在示例代码中心中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

提交请求接口

请求说明

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/ocr/v1/correct_edu/create_task

URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token,参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/json

Body中放置请求参数，参数详情如下：

请求参数

参数	是否必选	类型	可选值范围	说明
image	和 url 二选一	string	-	图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过10M，最短边至少512px，最长边最大8192px，支持jpg/jpeg/png/bmp格式优先级： image > url ，当image字段存在时，url字段失效
url	和 image 二选一	string	-	图片完整url，url长度不超过1024字节，url对应的图片base64编码后大小不超过10M，最短边至少512px，最长边最大8192px，支持jpg/jpeg/png/bmp格式优先级： image > url ，当image字段存在时，url字段失效请注意关闭URL防盗链
only_split	否	bool	true/false	是否仅进行题目切分，默认不打开，即：false。可选值包括： - true ：开启； - false：不开启开启时按照同步接口进行返回，且仅扣除智能作业批改-题目切分的额度

请求代码示例

提示：使用示例代码前，请记得替换其中的示例Token、文档地址或Base64信息。

curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/correct_edu/create_task?access_token=【调用鉴权接口获取的token】' 
 -H 'Content-Type: application/json'
--data '{
    "url": "https://ai.bdstatic.com/file/088749BAB26D4809B8A0B96FE100E7F0"
}'

# encoding:utf-8

import requests
import base64

'''
智能作业批改提交请求
'''

request_url = "https://aip.baidubce.com/rest/2.0/ocr/v1/correct_edu/create_task"
# 二进制方式打开图片文件
f = open('[本地文件]', 'rb')
img = base64.b64encode(f.read()).decode('utf-8')

params = json.dumps({
  "image": img
})

access_token = '[调用鉴权接口获取的token]'
request_url = request_url + "?access_token=" + access_token
headers = {'content-type': 'application/json'}
response = requests.post(request_url, data=params, headers=headers)
if response:
    print (response.json())

package com.baidu.ai.aip;

import com.baidu.ai.aip.utils.Base64Util;
import com.baidu.ai.aip.utils.FileUtil;
import com.baidu.ai.aip.utils.HttpUtil;
import com.google.gson.Gson;
import java.util.HashMap;
import java.util.Map;

/**
* 智能作业批改提交请求
*/
~~public class CorrectEduCreateTask~~{

    /**
    * 重要提示代码中所需工具类
    * FileUtil,Base64Util,HttpUtil,GsonUtils请从
    * https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72
    * https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2
    * https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3
    * https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3
    * 下载
    */
    public static String correctEduCreateTask() {
        // 请求url
        String url = "https://aip.baidubce.com/rest/2.0/ocr/v1/correct_edu/create_task";
        try {
            // 本地文件路径
            String filePath = "[本地文件路径]";
            byte[] imgData = FileUtil.readFileByBytes(filePath);
            String imgStr = Base64Util.encode(imgData);

            // 构造请求体
            Map&lt;String, Object&gt; map = new HashMap&lt;&gt;();
            map.put("image", imgStr); // 或者使用 url 参数
            String param = new Gson().toJson(map);

            // 注意这里仅为了简化编码每一次请求都去获取access_token，线上环境access_token有过期时间， 客户端可自行缓存，过期后重新获取。
            String accessToken = "[调用鉴权接口获取的token]";

            String result = HttpUtil.post(url, accessToken, "application/json", param);
            System.out.println(result);
            return result;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

    public static void main(String[] args) {
        ~~CorrectEduCreateTask.correctEduCreateTask()~~;
    }
}

返回说明

返回参数

字段	类型	说明
log_id	uint64	唯一的log id，用于问题定位
error_code	int	错误码
error_msg	string	错误描述信息
result	dict	返回的结果列表
+ task_id	string	该请求生成的任务ID，后续使用该task_id获取批改结果

返回示例

成功返回示例：

{
    "error_code": "0",
    "error_msg": "",
    "result": {
        "task_id": "1996199501805445169"
    },
    "log_id": 1996199501805445169
}

失败返回示例（详细的错误码说明见API文档-错误码）：

{
    "log_id": 1965746008642488944,
    "error_msg": "image format error",
    "error_code": 216201
}

获取结果接口