创建作文批改

接口描述

• 提交一篇作文进行后台批改

注意事项

1. AI评分具有主观性，仅供参考；
2. 图片质量差（如含大片深色内容）可能导致识别失败；
3. 内容含敏感词（政治、色情、暴力等）将无法批改。
4. 作文批改有一定的失败几率，比如图片url读取失败、文字未识别到、内容违规等等异常
5. 使用图片模式时，平台会先进行 OCR 识别，若有效文字内容过少（约小于30字）将视为识别失败，不再进入后续错别字检查与批改流程
6. 错别字检查阶段若判定作文错别字占比过高（约超过85%），将直接返回”错别字检查失败，不予批改”的结果
7. 以上两种情况平台都会回调到合作方的 callback_url，顶层 code=0，并在 data.error_code 中返回：
   • 1000：错别字占比过高，不予批改
   • 1001：图片识别失败或识别文字过少
     具体说明可参考《开放平台说明》中”作文批改相关业务错误码说明”

请求说明

• HTTP 方法：post
• 请求地址

  https://api.21days.cloud/opi/p/c012/create_zuowen  

• URL参数：无
• Header：accessToken鉴权
• Body：

字段名称	类型	默认值	是否可选	说明
subject	String	‘语文’	否	作文所属学科，可选值：’语文’ 或 ‘英语’
total_score	Number	100	否	作文总分（只能设为100，自行按比例换算用户设定分值，如用户设40分，60/100分换算为24/40分，对应优良中差、ABCD标准）
words_count	Number	400	否	作文字数要求
grade	String	‘四年级’	否	适用年级（如’三年级’、’九年级’、’初二’）
writing_type	String	‘不限’	是	作文类型（写人/叙事/写景/状物记叙文、抒情文、议论文等；中小学建议普通版，初高中建议pro版）
title	String	‘题目自拟’	是	作文标题，若留空需通过题干明确主题
topic_content	String	‘’	是	作文题干，描述写作要求、主题等核心指引
correct_standard	String	‘’	是	评分标准（包含内容、结构、语言等维度，支持自定义）
images	Array	[]	是	作文原图URL列表（示例：[{"url":"...","width":864,"height":1920}]） 要求：图片需剪裁避免地板、桌面等深色内容，（必须公开可访问），格式为jpg/jpeg/png/bmp，单图≤4M，最长边≤4096px。
item	Array	[]	是	批改结果类型（可包含评分、评语、批注等，支持以下维度： 评分、改写标题、改写开头结尾、修改错误、评语、段评、亮点、写作要求、写作思路、不足和建议、提问、精简批改）
score_items	Array	[]	是	评分细项（示例：内容、表达、结构、情感、主题），只有在item中包含”评分”的情况下才有效。为空时不返回评分明细
version	Number	1	是	可以得到不同的批改结果，详情可见 6.英语作文V2 7.英语作文V3 8.语文作文v2(含高级评分)。平台会根据 subject + version 自动生成版本名称，并在回调结果/详情查询的 data.version_name 中返回，例如：cn_v1、en_v2、en_v3
strictness	String	null	是	评分宽松度（仅英语 v4 生效），可选值：lenient（宽松）、normal（标准）、strict（严苛）。不传或传空按 normal 处理
transmission	Object	null	是	透传字段，支持对象结构；平台不会修改该内容，并会在回调结果 data.transmission 中原样返回，便于业务侧做请求关联与对账

响应说明

字段	类型	必选	示例	解释
code	Number	是	0	1=正常，0=异常，-1=未登录
msg	String	否	-	提示信息
data	object	否	{“id”: “u3EDmPW”}	核心数据（作文ID）

• 提交成功后会立即返回作文ID，后台异步执行批改流程

• 批改完成后的回调结果与详情查询结果中，会额外返回 data.version_name 字段，方便业务方区分不同批改版本

• 联调建议：

  • 服务端需确保 callback_url 在 3 秒内可返回 HTTP 200，任何非 200 状态码都会视为未收到结果；
  • 平台会按约 3 秒一次的频率最多重试 10 次，成功收到 200 后不再重试；
  • 回调数据结构与字段说明详见《发送作文批改结果》与《英语作文v3版本批改》。