语文作文批改 V3（三档润色）

测试中，未正式开放

一句话说明

语文作文三档润色版：共用创建接口，传 subject=语文、version=3。
评分 / 旁批 / 错别字接近 V1；一次返回 轻润色 / 中度润色 / 大改写 三档润色稿，方便老师或学生自选。
新对接若以评分为主，请优先语文 V2；版本对照见语文版本怎么选。

创建入口：创建作文批改
回调总览：发送作文批改结果
发版说明：开放平台发版说明

你会得到什么

你要的	在哪里	说明
版本标识	`version_name`	固定 `cn_v3`
评分	`pigai.score` + `score_items`	与 V1 同类（非 V2 高级评分）
默认润色稿	`runse.title/content/explain`	中度润色
另外两档	`runse.versions`	`轻润色`、`大改写` 各 1 篇

合起来共 3 档，无重复。老对接方只读顶层 runse 仍可展示中度稿。

如何启用

字段	取值
subject	`语文`
version	`3`
writing_type	与 V2 共用白名单，尽量细分
strictness	可选；影响评分口径（非 V2 那套等级换算）

与其他版本比

完整对照见语文版本怎么选。本版核心差异是三档润色；评分接近 V1，不是 V2 等级制。

计费

与 V1 同档：约 1 次 / 0.2 元（Pro 按约定）。

三档润色怎么读

档位	位置	说明
中度润色	顶层 `runse`	默认展示：在原文主线上调整详略、结构与表达
轻润色	`runse.versions` 中 `level=轻润色`	尽量保留学生原貌，只改通顺与衔接
大改写	`runse.versions` 中 `level=大改写`	可较大幅度重写，接近优秀范文水平

versions 每项含：level / title / content / explain。

特殊识别场景说明

当常规图片识别失败时，本版可能启用备用识别。此时回调可能出现：

特征	表现
`ocr_text.vision_only`	`true`
旁批 / 错别字	可能为空
评分 / 批改 / 润色	仍可能正常返回

产品侧请兼容「无旁批坐标但仍有总分与润色」的情况。

评分松紧（strictness）

取值	效果（概括）
lenient	对轻微问题更宽容
normal	默认，常规标准
strict	对问题更敏感、高分更克制

不传按 normal。仅在需要评分时有意义。

请求示例

{
  "subject": "语文",
  "version": 3,
  "grade": "六年级",
  "writing_type": "写景为主的记叙文",
  "title": "秋天的校园",
  "topic_content": "抓住景物特点，写出你的感受。",
  "strictness": "normal",
  "item": ["评分", "评语", "亮点"],
  "images": [
    { "url": "https://example.com/essay1.jpg", "width": 864, "height": 1920 }
  ],
  "callback_url": "https://partner.example.com/callback"
}

runse 结果短示例

{
  "runse": {
    "title": "秋天的校园",
    "content": "（中度润色正文）",
    "explain": "1. …",
    "versions": [
      {
        "level": "轻润色",
        "title": "秋天的校园",
        "content": "（轻润色正文）",
        "explain": "1. …"
      },
      {
        "level": "大改写",
        "title": "落叶里的校园",
        "content": "（大改写正文）",
        "explain": "1. …"
      }
    ]
  }
}

对接检查清单

已确认账号开通 V3（beta）
version=3，文体尽量细分
默认展示读顶层 runse；需要三档时再读 versions
兼容 vision_only 时旁批 / 错别字为空
不要按 V2 去找 score_detail

关联文档

主题	文档
版本对照	语文版本怎么选
创建接口	创建作文批改
回调	发送作文批改结果
新对接推荐	语文 V2
标准版	语文 V1