语文作文批改 V3

测试中，未正式开放

接口描述

提交一篇语文作文进行后台批改，与 V1 / V2 共用同一个 /p/c012/create_zuowen 接口。
V3 仅在润色阶段返回多版本：一次性输出 3 个不同改写幅度 的润色文章，便于合作方让老师/学生在 轻润色 / 中度润色 / 大改写 中自行选择。
落库时拆成默认 1 篇（中度润色）+ 额外 2 篇（轻润色 / 大改写）：默认字段 runse.title/content/explain 取最平衡的中档版，runse.versions 数组只放剩余 2 篇，前端展示 1 + 2 = 3 篇且无重复。
评分、批改、旁批等其它结构与 V1 标准版保持一致；不计入高级评分，仍按普通版价位 0.2 元/次计费。

与已有版本对比

对比项	标准版 V1	高级评分版 V2	多版本润色版 V3（本接口）
评分方式	AI 输出分数	独立高级评分系统	AI 输出分数（与 V1 一致）
评分粒度	单项 0-100 分	每维度 A/B/C/D 等级，加权折算总分	单项 0-100 分
偏题检测	无	自动判断任务符合度，偏题自动限分	无
润色结果	`runse` 单个版本（title/content/explain）	`runse` 单个版本（与 V1 同结构）	默认字段（中度润色）+ `runse.versions`（轻润色 / 大改写 2 篇），合计 3 篇
`version_name`	`cn_v1`	`cn_v2`	`cn_v3`
计费	0.2 元/次	高级版价格	0.2 元/次（与 V1 同价位）
适用学科	语文 / 英语	仅语文	仅语文
评分宽松度	不支持	支持 `strictness` 三档	支持 `strictness` 三档（提示词口径调整）

注意事项

文体类别需传正确的细分文体（与 V2 共用同一份白名单，详见 V2 文档）。
V3 不支持高级评分系统，传 version=3 时 score_items 字段仍由 V1 同款 AI 完成。
润色阶段一次性输出 3 档
其余注意事项与 V1 一致：
- AI 评分具有主观性，仅供参考；
- 图片质量差可能导致识别失败；
- 敏感词内容无法批改；
- OCR 文字过少（约小于 30 字）将视为识别失败；
- 错别字率过高会直接返回”不予批改”。
多模态 OCR 兜底：仅 cn_v3 且常规 OCR 失败时触发；回调中 ocr_text.vision_only=true，旁批与错别字为空，批改/润色/评分仍正常。详见发送批改结果「cn_v3 多模态 OCR 兜底」。
素材推送：需在创建时 item 数组传入 素材推送 关键字，回调才可能附带 materials_push；默认不开启（null）。

评分宽松度（strictness）

V3 评分由 AI 直接输出分数（与 V1 一致，不走高级评分系统），因此三档松紧通过提示词口径实现。

取值	含义	效果
`lenient`	宽松	对轻微问题更宽容，只要不影响整体表达与立意不轻易扣分，对真实亮点更积极给分
`normal`	标准	默认；按常规统考标准评分，客观中性
`strict`	严苛	对问题更敏感、对亮点认定更克制，结构/表达/立意都出色才给高分

不传或传空按 normal 处理，与上线前行为一致。
仅当创建时 item 包含「评分」（或未传 item 走默认全项）时生效；不评分场景该字段无影响。
与 语文作文v2、英语作文v4 共用同一请求字段 strictness。

请求说明

HTTP 方法：post
请求地址

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

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

字段名称	类型	默认值	是否可选	说明
subject	String	‘语文’	否	固定传 `语文`
version	Number	—	否	固定传 3，标识使用 V3 多版本润色
total_score	Number	100	否	作文总分
words_count	Number	400	否	作文字数要求
grade	String	‘四年级’	否	适用年级
writing_type	String	‘不限’	是	文体类别，与 V2 共用白名单
title	String	‘题目自拟’	是	作文标题
topic_content	String	‘’	是	作文题干
correct_standard	String	‘’	是	评分标准
images	Array	[]	是	作文原图 URL 列表
item	Array	[]	是	批改结果类型，与 V1 一致；需传 `素材推送` 才可能在回调中返回 `materials_push`（默认 null）

其它通用字段（如 callback_url、is_dev、is_pro、transmission、skip_injection_check、continuation_text、topic_content_images）详见《创建作文批改》。

响应说明

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

提交成功后会立即返回作文 ID，后台异步执行批改 + 多版本润色流程。
批改 / 旁批 / 错别字 / OCR 等字段的通用结构详见《发送作文批改结果》。

回调结果中的 runse 字段

V3 在原 runse 字段上新增 versions 数组。默认字段 title/content/explain 取 中度润色 作为最平衡的中档版本；versions 数组仅放额外 2 篇（轻润色 + 大改写），合起来一共 3 篇且无重复。

字段名	类型	描述
title	string	默认版本作文标题（中度润色档）
content	string	默认版本作文正文（中度润色档，使用换行符分段）
explain	string	默认版本润色说明（中度润色档）
versions	array	额外 2 篇可选版本：`轻润色` 与 `大改写`，与默认中档版互补，不重复

兜底：AI 偶发未输出 中度润色 档位时，默认字段会自动回退到 versions 排序后的次中间元素，确保 title/content/explain 不为空。

versions 数组元素结构

字段名	类型	描述
level	string	改写档位，固定 `轻润色` / `大改写`（默认中档版本不再出现在 versions 中）
title	string	当前档位润色后的作文标题
content	string	当前档位润色后的完整正文，使用换行符分段
explain	string	当前档位润色说明（按数字序号列出”改了什么、为什么这样改”）

档位语义

轻润色：尽量保留学生原文表达和真实水平，仅修正用词、表达不通顺、衔接生硬等问题，整体面貌仍像学生本人作品。
中度润色（默认）：在原文主线基础上调整段落顺序与详略、补充感官与心理细节，让结构更紧凑、立意更鲜明。
大改写：可较大幅度重写，重新组织结构、加强立意、丰富选材与修辞，达到优秀范文水平。

回调示例（仅展示 V3 关键差异部分）

{
  "code": 1,
  "msg": "批改成功",
  "data": {
    "zuowen_id": "u3EDmPW",
    "version_name": "cn_v3",
    "status": 1,
    "...": "ocr_text / pangpi / wrong_words / pigai 等字段同 V1（参见《发送作文批改结果》）",
    "runse": {
      "title": "（中度润色版本标题，作为默认中档版）",
      "content": "（中度润色版本正文，作为默认中档版）",
      "explain": "1. 调整了段落详略\n2. 补充了感官细节...",
      "versions": [
        {
          "level": "轻润色",
          "title": "...",
          "content": "...",
          "explain": "1. 修正了几处用词错误\n2. 衔接更顺畅..."
        },
        {
          "level": "大改写",
          "title": "...",
          "content": "...",
          "explain": "1. 重新组织了结构\n2. 加强了立意..."
        }
      ]
    }
  }
}

提示：

老消费方按 runse.title / content / explain 即可读到一篇中档润色默认版，行为基本不变（只是档位从轻润色换成中度润色，更适合直接展示）。

新消费方建议把默认字段当作”第一篇”，再把 runse.versions 里的 2 篇作为”备选档位”展示，共 3 档无重复。

语文作文批改-系列：