题小小作文批改-文档

查询小练笔批改详情通过创建接口返回的 ID 查询小练笔批改结果，用于事后对账、补拉数据或排查问题。 注意：数据只保存 1 周，且 30 秒更新一次，可能非实时数据，以回调通知数据为准。 HTTP 方法：get请求地址1https://api.21days.cloud/opi/p/c012/micro_writing/detail 请求参数 字段名 类型 描述 micro_writing_id string 创建小练笔批改时返回的 data.id 返回响应 字段 类型 必选 示例 解释 code Number 是 1 1=正常，0=异常，-1=未登录 msg String 否 - 提示信息 data object 否 见示例 与回调接口 data 结构一致，额外包含 micro_writing_id data 字段说明data 字段结构与回调接口《发送作文批改结果》中 data 完全一致，常用字段包括： 字段名 类型 描述 micro_writing_id string 当前小练笔任务 ID（创建接口返回的 ...

创建小练笔批改接口描述 提交一段“小练笔/微写作”进行后台批改，针对 1~3 个训练目标输出短、准、可执行的反馈。 支持两种作答模式： 文本模式：直接传 content。 图片模式：传 images，平台先 OCR 识别再批改。 注意事项 AI 评分具有主观性，仅供参考。 文本模式下 content 长度需在 10~3000 字之间，过长建议改用大作文批改接口（《创建作文批改》）。 图片模式下每张图片需提供 url / width / height，单次最多 10 张，且图片需公开可访问；格式 jpg/jpeg/png/bmp，单图 ≤ 4M，最长边 ≤ 4096px。 title 与 topic_content 不能同时为空。 与大作文一致，平台会异步执行批改，完成后通过 callback_url 推送结果；详细字段定义见《发送作文批改结果》。 失败回调中可能携带与大作文相同的业务错误码（如 1000 错别字过多、1001 OCR 识别失败），详见《开放平台说明》。 请求说明 HTTP 方法：post 请求地址1https://api. ...

发送作文批改结果（英语v4）当作文为英语且使用 v4 批改方案时，平台会将批改结果推送到业务方回调地址。 说明： V4 在 V3 基础上升级了评分体系：评分由独立评分模块完成，采用”基础等级 + 发展等级”双轨评分，按学段（初中/高中）使用不同的评分维度和满分，评分结果更加细致和稳定； 批改反馈部分（comment、suggestion_items、highlight_items）与 V3 一致； V4 结果依旧通过《发送作文批改结果》中约定的回调方式下发，pigai 字段结构在 V3 的基础上用 score + score_detail 替换了原来的 total_score + score_items；score_detail 内同时提供了 score_items 扁平列表以兼容 V3 消费方式； 回调结果与详情查询中会返回 data.version_name = 'en_v4'，便于区分英语 V4 版本； 所有说明性文字（如 comment、reason、评分理由）统一为中文，示例句保持英文原文； 计费说明：V4 采用高级评分，每次批改消耗 1.5 次 ...

按年级上下册单元获取单元作文详情用于按 grade + season + unit 查询平台内置的单元同步作文题目要求，适合合作方在“同步作文 / 单元作文”场景下预填作文标题、题干、建议字数和总分。 HTTP 方法：GET 请求地址1https://api.21days.cloud/opi/p/c012/zuowen/unit URL参数： 字段名 类型 是否必填 描述 grade int 是 年级，如 3=三年级、4=四年级 season int 是 上下册，1=上册，2=下册 unit int 是 单元编号，如 1、2、3 Header：accessToken 鉴权 返回响应 字段 类型 必选 示例 解释 code Number 是 1 1=正常，0=异常，-1=未登录 msg String 否 - 提示信息 data array 是 [] 单元作文详情列表 data 数组项字段说明 字段名 类型 示例 描述 id int 123 单元作文配置 ID grade ...

创建带高级评分功能的语文作文批改接口描述 提交一篇语文作文进行后台批改，并使用高级评分系统独立完成评分 批改流程与标准版一致，评分环节由高级评分系统替代标准版 AI 直评 高级评分 vs 标准评分 对比项 标准版（《创建作文批改》） 高级评分（本接口） 评分方式 AI 输出分数 独立评分系统 评分维度 由 score_items 参数自定义 不支持自定义，系统内置 评分粒度 单项 0-100 分 每维度 A/B/C/D 等级，加权折算为总分 偏题检测 无 自动判断任务符合度，偏题作文自动限分 结果位置 pigai.score + pigai.score_items pigai.score + pigai.score_detail 适用学科 语文 / 英语 仅语文 注意事项 . 仅支持语文，英语作文请使用标准版或 V2/V3 接口 . 文体类别，必须传正确的文体（题目要求的文体类别，尽量细分，比如能判断是【写人为主的记叙文】就不要填【记叙文】。只有文体不限、多个文体的情况下，才可以填【不限】 . ite ...

发送作文批改结果（英语v3）当作文为英语且使用 v3 批改方案时，平台会将批改结果推送到业务方回调地址。 说明： 等级不单独返回，请业务方根据 total_score 自行换算等级； 所有说明性文字（如 comment、reason）统一为中文，示例句保持英文原文，便于在中文环境中直接展示； V3 结果依旧通过《发送作文批改结果》中约定的回调方式下发，只是 pigai 字段结构升级为更细粒度的英文专用结构。 回调结果与详情查询中会返回 data.version_name = 'en_v3'，便于区分英语 V3 版本。 Body： 在创建作文基础上，当subject=英语时，可以传version=3。其他字段参考创建作文 字段名称 类型 默认值 是否可选 说明 version String ‘1’ 是 传3即可进入本接口 1. 请求信息 HTTP 方法：post 请求地址：1https:回调URL 2. 请求参数（顶层） 字段名 类型 描述 ocr_text object OCR 识别结果 pangp ...

英语作文批改V2批改更侧重于改错 当在「02.创建作文批改」接口中满足以下条件时，将自动进入 V2 改错模式： subject = '英语' 且 version = 2 回调结果与详情查询中会返回 data.version_name = 'en_v2' 该模式下，整体批改结构与普通模式一致，但 更强调语法与表达错误的发现与修正，核心能力体现在 pigai.mod_items 与 pigai.more_items 两个字段中。 Body： 在创建作文基础上，当subject=英语时，可以传version=2。其他字段参考创建作文 字段名称 类型 默认值 是否可选 说明 version String ‘1’ 是 传2即可进入本接口 pigai对象细节 字段名 类型 描述 score int 作文评分（0-100） mod_items array 修改细节（针对明显错误给出逐条修改建议） more_items array 更多提升（在正确基础上的高级表达优化） mod_items 细节 ...

作文看图写作,生成文字题干将提供的图片,转成示意的文字。适用于看图写话图片转为文字材料。 HTTP 方法：POST 请求地址1https://api.21days.cloud/opi/p/c012/zuowen/image_to_topic URL参数：无 Header：accessToken鉴权 Body： 字段名 类型 描述 topic_content_image string 图片链接字符串，需为公网可访问的图片 URL，建议使用清晰的原始题图（避免包含课本边框、桌面等大面积无关区域） language int 需要哪种语言，0=中文，1=英语。目前主要用于控制返回题干语言，不影响图片识别准确性 3. 返回响应 字段 类型 必选 示例 解释 code Number 是 0 1=正常，0=异常，-1=未登录 msg String 否 - 提示信息 data object 否 data.topic_content str 否 返回的文本 使用建议与常见异常 图片建议： 尽 ...

查询作文详情可以通过ID查询作文详情。 注意：数据只保存1周时间，且30秒更新一次，可能非实时数据，以回调通知数据为准。 HTTP 方法：get请求地址1https://api.21days.cloud/opi/p/c012/detail 请求参数： 字段名 类型 描述 zuowen_id string zuowen_id 返回响应 字段 类型 必选 示例 解释 code Number 是 0 1=正常，0=异常，-1=未登录 msg String 否 - 提示信息 data object 否 与作文批改结果一致，见 第3步 其中 data 字段结构与回调接口《发送作文批改结果》中 data 完全一致，包括但不限于： ocr_text / pangpi / wrong_words / pigai / runse 等批改结果字段； version_name 版本名称字段（例如：cn_v1、en_v2、en_v3）； status、note 等内部状态字段（例如记录 ...

发送作文批改结果作文批改耗时较长，批改完成后会发送post请求到此url，收到后，请回复200状态，其他任何状态视为未收到消息，未收到消息将在后续每3秒通知一次，一共通知10次，成功收到回复后不再通知 HTTP 方法：post 请求地址1https:回调URL Body：平台会向回调地址发送一个 JSON 对象，顶层结构如下： 123456789{ "code": 1, "msg": "批改成功", "data": { "zuowen_id": "u3EDmPW", "version_name": "cn_v1", "...": "以下字段均位于 data 中" }} 后文中列出的 ocr_text、pangpi、wrong_words、pigai、runse、transmission、version_name 等字段 ...