题小小作文批改-文档

英语作文批改 V4变更记录 完整发版总览见 开放平台发版说明（2026-05-28）。 发版日期 适用版本 类型 变更摘要 详情 2026-05-28 en_v4 🟡 优化 发版交叉引用：strictness 三档已上线 见下文「strictness」 2026-05-28 en_v4 🟢 新增 公共能力：continuation_text、1002 见 创建作文、发送批改结果 当作文为英语且使用 v4 批改方案时，平台会将批改结果推送到业务方回调地址。 说明： V4 在 V3 基础上升级了评分体系：评分由独立评分模块完成，采用”基础等级 + 发展等级”双轨评分，按学段（初中/高中）使用不同的评分维度和满分，评分结果更加细致和稳定； 批改反馈部分（comment、suggestion_items、highlight_items）与 V3 一致； V4 结果依旧通过《发送作文批改结果》中约定的回调方式下发，pigai 字段结构在 V3 的基础上用 score + score_detail 替换了原来的 total_score + score_ite ...

单元作文详情用于按 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 int 3 年级 ...

语文作文批改 V2（高级评分） 发版与变更记录见 开放平台发版说明。 接口描述 提交一篇语文作文进行后台批改，并使用高级评分系统独立完成评分 批改流程与标准版一致，评分环节由高级评分系统替代标准版 AI 直评 高级评分 vs 标准评分 对比项 标准版（《创建作文批改》） 高级评分（本接口） 评分方式 AI 输出分数 独立评分系统 评分维度 由 score_items 参数自定义 不支持自定义，系统内置 评分粒度 单项 0-100 分 每维度 A/B/C/D 等级，加权折算为总分 偏题检测 无 自动判断任务符合度，偏题作文自动限分 结果位置 pigai.score + pigai.score_items pigai.score + pigai.score_detail 适用学科 语文 / 英语 仅语文 评分宽松度 不支持 支持 strictness 三档（见下文） 注意事项 . 仅支持语文，英语作文请使用标准版或 V2/V3 接口 . 文体类别，必须传正确的文体（题目要求的文体类别，尽量细分，比如 ...

英语作文批改 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 识别结果 pangpi obj ...

英语作文批改 V2批改更侧重于改错 当在 创建作文批改 接口中满足以下条件时，将自动进入 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=英语。目前主要用于控制返回题干语言，不影响图片识别准确性 retry int 重试次数，默认 5；仅用于平台内部多次尝试生成题干，通常无需传 3. 返回响应 字段 类型 必选 示例 解释 code Number 是 0 1=正常，0=异常，-1=未登录 msg String 否 - 提示信息 data object 否 data.topic_conten ...

查询作文详情变更记录 完整发版总览见 开放平台发版说明（2026-05-28）。 发版日期 适用版本 类型 变更摘要 详情 2026-05-28 cn_v1~cn_v3 🟢 新增 data.materials_push（opt-in，默认 null） 见《发送作文批改结果》 2026-05-28 全部批改版本 🟢 新增 失败时 error_code=1002 见《发送作文批改结果》 2026-05-28 全部批改版本 🟢 新增 未作答场景（continuation_text） 见《发送作文批改结果》「未作答兜底」 可以通过ID查询作文详情。 注意：数据只保存1周时间，且30秒更新一次，可能非实时数据，以回调通知数据为准。 HTTP 方法：get请求地址1https://api.21days.cloud/opi/p/c012/detail 请求参数： 字段名 类型 描述 zuowen_id string zuowen_id 返回响应 字段 类型 必选 示例 解释 code Number 是 0 1=正常，0= ...

发送作文批改结果变更记录 完整发版总览见 开放平台发版说明（2026-05-28）。 发版日期 适用版本 类型 变更摘要 详情 2026-05-28 cn_v1~cn_v3 🟢 新增 回调可返回 materials_push（需创建时 item 含 素材推送） 见「materials_push 字段」 2026-05-28 全部批改版本 🟢 新增 失败回调 error_code=1002（提示词注入） 见「顶层 code 与业务错误码说明」 2026-05-28 全部批改版本 🟢 新增 未作答兜底（传 continuation_text 时） 见「未作答兜底」 2026-05-28 cn_v3 🟢 新增 多模态 OCR 兜底（ocr_text.vision_only） 见「cn_v3 多模态 OCR 兜底」 2026-05-28 cn_v3 🔵 文档修正 默认润色=中度润色；versions 里面有额外 2 篇 见「runse.versions 数组」 作文批改耗时较长，批改完成后会发送post请求到此url，收到后，请回复200状 ...

创建作文批改变更记录 完整发版总览见 开放平台发版说明（2026-05-28）。 发版日期 适用版本 类型 变更摘要 详情 2026-05-28 全部批改版本 🟢 新增 入参 continuation_text（未作答检测） 见「请求说明」 2026-05-28 cn_v1~cn_v3 🟢 新增 item 含 素材推送 时回调可返回 materials_push 见《发送作文批改结果》 2026-05-28 全部批改版本 🟢 新增 失败回调可能含 error_code=1002 见「注意事项」第 7 条 2026-05-28 — 🟡 优化 version 说明补全各版本文档链接 见「请求说明」 接口描述 提交一篇作文进行后台批改 注意事项 AI评分具有主观性，仅供参考； 图片质量差（如含大片深色内容）可能导致识别失败； 内容含敏感词（政治、色情、暴力等）将无法批改。 作文批改有一定的失败几率，比如图片url读取失败、文字未识别到、内容违规等等异常 使用图片模式时，平台会先进行 OCR 识别，若有效文字内容过少（约小于30字）将视为 ...

简介题小小作文开放平台面向教育厂商、机构与 SaaS 产品，提供作文批改、润色、旁批、范文生成等能力的 HTTP API。合作方在自有产品中完成上传与展示，平台负责 OCR、AI 批改与结果回调，无需自建大模型与教研 Prompt 体系。 接入前请阅读 开放平台说明，接口清单见 接口总览索引。 核心亮点能力完整，一次对接覆盖主场景 中英文作文批改：语文 V1/V2/V3、英语 V1/V2/V3/V4 多版本并存，按 version_name 选型，新对接英语建议优先 V4 手写 OCR：支持图片上传，自动识别手写稿并进入批改流水线 结构化输出：评分、总评、逐句批改、旁批坐标、润色稿等字段统一 JSON 回调，便于直接渲染 专项能力：小练笔微写作、班级作文报告（beta）、生成范文（beta）、教材单元作文、看图生成题干等独立接口 教研沉淀，效果可对标一线产品 10 余种经教研长期调教的批改模板，覆盖评分、评语、亮点、建议、思路点拨等维度 语文高级评分（V2）：独立评分系统，维度 A/B/C/D 等级 ...