> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigmodel.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 作业批改（已下线）

* 作业批改（题库）：用户拍照上传作业/试卷等作答图片，可输出用户每道题的批改结果；同时支持数学和理综学科的解析输出。
* 智能批改（模型）：使用大模型能力，支持 `is_finish` 未完成的结果查询。
* 智能结果解析（模型）：使用大模型能力，支持语文、英语和文综学科的解析查询。

<CardGroup cols={2}>
  <Card title="详细说明" icon={<svg style={{maskImage: "url(https://mintcdn.com/zhipu-ef7018ed/6jZAOYw-eXEZh1pv/resource/icon/book.svg?fit=max&auto=format&n=6jZAOYw-eXEZh1pv&q=85&s=f9a867079d7ff6967277ded330e6a683)", maskRepeat: "no-repeat", maskPosition: "center center",}} className={"h-6 w-6 bg-primary dark:bg-primary-light !m-0 shrink-0"}/>} href="https://www.bigmodel.cn/marketplace/agent_detail/intelligent_education_correction_agent">
    查看介绍、核心功能、适用场景
  </Card>

  <Card title=" Agent API 文档" icon={<svg style={{maskImage: "url(https://mintcdn.com/zhipu-ef7018ed/6jZAOYw-eXEZh1pv/resource/icon/code.svg?fit=max&auto=format&n=6jZAOYw-eXEZh1pv&q=85&s=2f67130d1597ee0b68135487ec31662f)", maskRepeat: "no-repeat", maskPosition: "center center",}} className={"h-6 w-6 bg-primary dark:bg-primary-light !m-0 shrink-0"}/>} href="/api-reference/agent-api/%E6%99%BA%E8%83%BD%E4%BD%93%E5%AF%B9%E8%AF%9D">
    查看完整的 API 文档
  </Card>
</CardGroup>

## **价格**

按调用次数后付费，**0.12 元/次**

### **整体流程**

* 第一步：用户上传作业/试卷等图片URL，调用作业批改（题库）接口，获取批改结果
* 第二步：获取批改结果后，依情况进行
  * 对于题目批改结果results中的is\_finish为0的题目，需要调用智能批改（模型）接口，获取智能批改结果。
  * 对于题目批改结果results中的is\_finish为1的题目，表示已命中题库并正确获取了批改结果。
* 第三步：对于语文、英语和文综学科的批改结果，可以调用批改结果解析接口，获取解析结果。

## **接口文档**

### **作业批改（题库）**

### **接口请求**

| 传输方式   | https                                                                            |
| :----- | :------------------------------------------------------------------------------- |
| 请求地址   | [https://open.bigmodel.cn/api/v1/agents](https://open.bigmodel.cn/api/v1/agents) |
| 调用方式   | 同步调用，等待模型完成执行并返回最终结果                                                             |
| 字符编码   | UTF-8                                                                            |
| 接口请求格式 | JSON                                                                             |
| 响应格式   | JSON                                                                             |
| 接口请求类型 | POST                                                                             |
| 开发语言   | 任意可发起 http 请求的开发语言                                                               |

### **请求参数**

| 参数名称              | 类型            | 是否必填 | 说明                                                                                                     |
| :---------------- | :------------ | :--- | :----------------------------------------------------------------------------------------------------- |
| agent\_id         | String        | 是    | 智能体唯一 ID，用于计费、流控、参数管理等；<br />与 `mode_code` 生效逻辑一致。智能体id：<br />`intelligent_education_correction_agent` |
| messages          | List\<Object> | 是    | 会话消息列表，按顺序组成上下文。每个元素<br />结构如下：该接口只能传一个 message 对象                                                     |
| └─ role           | String        | 是    | 消息角色，目前仅支持 `user`                                                                                      |
| └─ content        | List\<Object> | 是    | 消息内容主体，包含：                                                                                             |
|     └─ type       | String        | 是    | 内容类型，支持 `image_url`                                                                                    |
|     └─ image\_url | String        | 是    | 当 `type="image_url"` 时的URL；<br />即要进行批改的作业的图片URL                                                       |

### **智能批改（模型）**

使用大模型能力，支持 `is_finish` 未完成的结果查询。

### **接口请求**

| 传输方式   | https                                                                                                      |
| :----- | :--------------------------------------------------------------------------------------------------------- |
| 请求地址   | [https://open.bigmodel.cn/api/v1/agents/async-result](https://open.bigmodel.cn/api/v1/agents/async-result) |
| 调用方式   | 同步调用，等待模型完成执行并返回最终结果                                                                                       |
| 字符编码   | UTF-8                                                                                                      |
| 接口请求格式 | JSON                                                                                                       |
| 响应格式   | JSON                                                                                                       |
| 接口请求类型 | POST                                                                                                       |
| 开发语言   | 任意可发起 http 请求的开发语言                                                                                         |

### **请求参数**

| 参数名称              | 类型            | 是否必填 | 说明                                                                            |
| :---------------- | :------------ | :--- | :---------------------------------------------------------------------------- |
| agent\_id         | String        | 是    | 智能体唯一 ID，用于计费、流控、参数管理等；<br />智能体id：`intelligent_education_correction_polling` |
| custom\_variables | Object        | 是    | 智能体扩展参数                                                                       |
| └─ trace\_id      | String        | 是    | 批改接口返回的 trace\_id                                                             |
| └─ images         | List\<Object> | 是    | 作业图片列表                                                                        |
|     └─ image\_id  | String        | 是    | 批改接口返回的 image\_id                                                             |
|     └─ uuids      | List\<String> | 是    | 批改接口返回的 uuid，只需要 is\_finish 为 0 的数据                                           |

### **智能结果解析（模型）**

使用大模型能力，支持语文、英语和文综学科的解析查询。

### **接口请求**

| 传输方式   | https                                                                            |
| :----- | :------------------------------------------------------------------------------- |
| 请求地址   | [https://open.bigmodel.cn/api/v1/agents](https://open.bigmodel.cn/api/v1/agents) |
| 调用方式   | 同步调用，等待模型完成执行并返回最终结果                                                             |
| 字符编码   | UTF-8                                                                            |
| 接口请求格式 | JSON                                                                             |
| 响应格式   | 标准Event Stream                                                                   |
| 接口请求类型 | POST                                                                             |
| 开发语言   | 任意可发起 http 请求的开发语言                                                               |

### **请求参数**

| 参数名称              | 类型     | 是否必填 | 说明                                                                             |
| :---------------- | :----- | :--- | :----------------------------------------------------------------------------- |
| agent\_id         | String | 是    | 智能体唯一 ID，用于计费、流控、参数管理等；<br />智能体id：`intelligent_education_correction_analysis` |
| custom\_variables | Object | 是    | 智能体扩展参数                                                                        |
| └─ question       | String | 是    | 批改返回题干或 OCR                                                                    |
| └─ image\_id      | String | 是    | 图片ID                                                                           |
| └─ uuid           | String | 是    | 问题 uuid                                                                        |
| └─ trace\_id      | String | 是    | 批改接口返回的 trace\_id                                                              |
