英语作文v4版本批改
发送作文批改结果(英语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
...
语文作文v2(含高级评分)
创建带高级评分功能的语文作文批改接口描述
提交一篇语文作文进行后台批改,并使用高级评分系统独立完成评分
批改流程与标准版一致,评分环节由高级评分系统替代标准版 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)当作文为英语且使用 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版本批改
英语作文批改V2批改更侧重于改错
当在「2.创建作文批改」接口中满足以下条件时,将自动进入 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 等字段 ...
创建作文批改
创建作文批改接口描述
提交一篇作文进行后台批改
注意事项
AI评分具有主观性,仅供参考;
图片质量差(如含大片深色内容)可能导致识别失败;
内容含敏感词(政治、色情、暴力等)将无法批改。
作文批改有一定的失败几率,比如图片url读取失败、文字未识别到、内容违规等等异常
使用图片模式时,平台会先进行 OCR 识别,若有效文字内容过少(约小于30字)将视为识别失败,不再进入后续错别字检查与批改流程
错别字检查阶段若判定作文错别字占比过高(约超过85%),将直接返回”错别字检查失败,不予批改”的结果
以上两种情况平台都会回调到合作方的 callback_url,顶层 code=0,并在 data.error_code 中返回:
1000:错别字占比过高,不予批改
1001:图片识别失败或识别文字过少具体说明可参考《开放平台说明》中”作文批改相关业务错误码说明”
请求说明
HTTP 方法:post
请求地址1https://api.21days.cloud/opi/p/c012/create_zuowen
URL参数:无
Header:accessT ...
题小小作文简介
题小小作文是一款智能批改作文的APP,依托于强大的人工智能技术,能实现手写文字精准识别,中、英、繁自动识别批改。
专业
10余种专业批改模板,由多位教研员长期调教
全网首创教材同步作文批改
支持定制评分标准和批改结果
润色效果在同行业中遥遥领先
不计成本,使用最好最贵的AI
批量
10分钟可批改全班作文
批改+润色,不用等结果,后台全搞定
批量导出、按学生分页
打印分发给学生,方便学生背诵
支持扫描仪录入、更快更准确
实用
配备网页版,可投屏上公开课
配备学生版,可平板上传查看结果
小程序/APP/网页版,多端数据共享
主要功能点作文批改
全面评分
改写标题、开头、结尾
修改错别字、用词不当、病句
写作手法、写作技巧分析
亮点分析
写作建议
思路点拨
结构分析与建议
全文段落批注
全文逐句批改
论点、论据、论证
作文润色
不改变原意,让作文更出彩
针对不同学生,使用不同语言风格
写作思路
审题——找到题目关键词,捕捉第一印象点,挖掘引申意义和深层次分析,分析情感、哲理、启示
立意——一句话确立全文中心思想,从不同角度去支撑
选材——选择合适的材料,让作文有 ...
