语文作文批改 V1

语文作文标准版批改方案。创建、入参、响应与异步流程均与 创建作文批改 共用同一接口，无需单独 URL。

发版与变更记录见 开放平台发版说明。
回调字段详见 发送作文批改结果，补拉见 查询作文详情。

如何启用本版本

在 创建作文批改 请求 Body 中设置：

字段 取值 说明
subject '语文' 必填
version 1 不传时默认为 1
is_pro 0 / 1 按普通版或 Pro 版计费链路，见商务约定

成功后回调与详情查询中 data.version_name 为 **cn_v1**。

版本特点

对比项 V1（本版本） V2 高级评分 V3 三档润色
评分方式 AI 直评 + 可自定义 score_items 独立高级评分，维度 A/B/C/D 与 V1 相同（AI 直评）
润色 单篇 runse 单篇 runse 默认中度 + runse.versions 2 篇（轻/大改写，共 3 档）
strictness 不生效 生效 生效（提示词口径）
素材推送 item 含 素材推送 时可返回 同左 同左
计费参考 普通版约 0.2 元/次 高级版价格 与 V1 同档

请求与响应

完整入参、注意事项、错误码一律以 创建作文批改 为准，本文不重复罗列。

对接时重点关注：

  • item：按需勾选评分、评语、旁批、润色等维度；语文可选 素材推送
  • score_items：在 item 含 评分 时生效，可自定义维度名称
  • continuation_text：续写题未作答检测（可选）
  • 提交成功返回 data.id，批改结果通过 callback_url 推送

升级选型

回调 / 详情 data 字段总览

批改完成后的回调 Body 与 查询作文详情 返回的 data 结构一致。V1 固定 version_name = cn_v1，无 score_detail（V2 专有）、无 runse.versions（V3 专有）。

字段 类型 说明
zuowen_id string 作文任务 ID
version_name string 固定 cn_v1
status number 1=完成，-1=失败（详情接口可见）
createtime / company_id number 详情接口可能附带
title string OCR 识别并修正后的标题
content string OCR 纠错前的正文（纯文本）
correct_words string OCR 纠错后的正文
ocr_text object 含 img_list、坐标、origin_content 等，详见《发送作文批改结果》
wrong_words object 逐字错别字，key 为下标字符串
pangpi object 旁批：commit_items + commit_total
pigai object 批改结果，字段随创建时 item 动态返回（见下节）
runse object 单篇润色：title / content / explain
materials_push object | null 仅 item 含 素材推送 时可能返回，默认 null
transmission object 创建时传入的透传字段，原样返回
note object | null 内部备注；未作答兜底时可能含 metrics

ocr_text、pangpi、wrong_words 的坐标层级与用法见 发送作文批改结果。下文重点说明 V1 的 pigai / runse 及完整示例。

pigai 字段说明（V1 标准版）

V1 使用 AI 直评：pigai.score 为总分（0~100），pigai.score_items 为维度明细。创建时若 item 不含某能力，对应字段不会出现在回调中。

字段 类型 触发条件（item） 说明
score int 含 评分 总分 0~100；偏题可为 0；会按错别字比例、字数比例扣减
score_items array 含 评分 维度评分明细；维度名来自创建时的 score_items，未传则用默认维度
score_items[].item string — 维度名称，如「主题立意」
score_items[].score int — 该维度 0~100
score_items[].reason string — 判分理由
requirements string 含 写作要求 本题写作要求与关注点
outline string 含 写作思路 若我来写的提纲（开头/中间/结尾）
title string 含 改写标题 修改后的标题；未改可与原文相同
title_reason string 含 改写标题 改标题原因；未改返回 ""
first_p string 含 改写开头结尾 改写后的开头段
first_p_reason string 含 改写开头结尾 改开头原因
last_p string 含 改写开头结尾 改写后的结尾段
last_p_reason string 含 改写开头结尾 改结尾原因
modify string 含 修改错误 病句/用词/逻辑等修改说明（忽略标点与错别字）
comment string 含 评语 总评；含 精简批改 时约 50 字，否则约 200 字
paragraphs array 含 段评 逐段点评字符串数组
highlights string 含 亮点 亮点分析
suggestions string 含 不足和建议 不足与改进建议，多条用 \n 分隔
questions array 含 提问 约 3 个引导思考的问题

V1 不会出现：score_detail（V2）、mod_items / more_items（英语 V2）、highlight_items / suggestion_items（英语 V3）、no_answer（仅未作答兜底场景）。

runse 字段说明（V1 单篇润色）

字段 类型 说明
title string 润色后标题（中文）
content string 润色后正文，段落用 \n 分隔
explain string 润色说明，按序号列出改了什么、为什么

V1 无 runse.versions 数组。

完整回调 JSON 示例（cn_v1）

以下为典型成功回调示例。ocr_text.img_list 仅保留结构示意（完整坐标示例见《发送作文批改结果》）；pigai / pangpi / runse / wrong_words 为可直接对接的完整形态。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
{
  "code": 1,
  "msg": "批改成功",
  "data": {
    "zuowen_id": "mSO9Ilx",
    "version_name": "cn_v1",
    "status": 1,
    "createtime": 1772053222,
    "company_id": 3,
    "title": "不错过生命之树",
    "content": "不错过生命之树\n大雨从天上倒灌而下，狂风夹杂着豆大的雨点，不断拍打着玻璃窗，暖黄的灯光下，作业本的字迹如海边的沙砾，混着窗外萧风扰乱着我的心神，我向窗外看去，院子里的那株海棠在狂风下已被压弯了腰，好像在呻吟着，痛苦着，我不忍心再看，熄灯睡去。\n翌日早晨，我早早起来，推开院门，院子里的景象触目惊心，落红落了满地，海棠树早已不似前几日那般富有生机，远方青山如黛，云鸟共舞，我却只能独自打扫眼前这片狼藉。忽然间，一处青绿夹着莹白闯入我的视野，我轻轻走过去，拨开那缠绕着的枝条，向深处望去，那是一片多么奇妙的景象！含苞待放的花苞在枝头上欢呼雀跃，明媚的精灵在绿野中舞动，墨绿的旧叶叠着新生的嫩叶，那是雨后的新生，但若细看，便会发现原本粗壮有力的枝干已被削去数根，裂纹在枝条上蔓延。不知何时，海棠花的嫩芽已长满了我的心房，香气温散，环绕在我的周围。\n眼前萧败的落红之景未再使我感到烦躁，落花的凋零并不是衰败，相反，它是新生的希望，海棠树汲取了养分，便会变得愈加茂盛，狂风之下的海棠树便会变得更加顽强，不惧风雨，正如人一样，困难之中，不断强大自己，才会长出属于自己的成功之花。蓬勃的生命力在心中蔓延，我替海棠树浇好了水，不再替它感到惋惜。岁月漫长，我们要不断携着勇气和希望奔赴下一场山海，挫折和失败便不再值得我们回首和驻足。\n回到房间，我坐下来潜心完成作业，海滩上的沙砾已被卷入大海，我望向窗外，窗外的海棠独立天地间，清风洒兰雪，我似乎看到了那片熠熠生辉的莹白，生命之树已种下了种子。",
    "correct_words": "不错过生命之树\n大雨从天上倒灌而下，狂风夹杂着豆大的雨点，不断拍打着玻璃窗，暖黄的灯光下，作业本的字迹如海边的沙砾，混着窗外萧风扰乱着我的心神，我向窗外看去，院子里的那株海棠在狂风下已被压弯了腰，好像在呻吟着，痛苦着，我不忍心再看，熄灯睡去。\n翌日早晨，我早早起来，推开院门，院子里的景象触目惊心，落红落了满地，海棠树早已不似前几日那般富有生机，远方青山如黛，云鸟共舞，我却只能独自打扫眼前这片狼藉。忽然间，一处青绿夹着莹白闯入我的视野，我轻轻走过去，拨开那缠绕着的枝条，向深处望去，那是一片多么奇妙的景象！含苞待放的花苞在枝头上欢呼雀跃，明媚的精灵在绿野中舞动，墨绿的旧叶叠着新生的嫩叶，那是雨后的新生，但若细看，便会发现原本粗壮有力的枝干已被削去数根，裂纹在枝条上蔓延。不知何时，海棠花的嫩芽已长满了我的心房，香气温散，环绕在我的周围。\n眼前萧败的落红之景未再使我感到烦躁，落花的凋零并不是衰败，相反，它是新生的希望，海棠树汲取了养分，便会变得愈加茂盛，狂风之下的海棠树便会变得更加顽强，不惧风雨，正如人一样，困难之中，不断强大自己，才会长出属于自己的成功之花。蓬勃的生命力在心中蔓延，我替海棠树浇好了水，不再替它感到惋惜。岁月漫长，我们要不断携着勇气和希望奔赴下一场山海，挫折和失败便不再值得我们回首和驻足。\n回到房间，我坐下来潜心完成作业，海滩上的沙砾已被卷入大海，我望向窗外，窗外的海棠独立天地间，清风洒兰雪，我似乎看到了那片熠熠生辉的莹白，生命之树已种下了种子。",
    "ocr_text": {
      "img_list": [
        {
          "url": "https://example.com/composition-page1.jpg",
          "width": 1344,
          "height": 1826,
          "columns": [
            {
              "left": 37,
              "right": 1328,
              "column": [
                [
                  ["大", 186, 109, 37, 52],
                  ["雨", 227, 109, 62, 52]
                ]
              ]
            }
          ]
        }
      ],
      "origin_content": "…OCR 原始拼接文本…",
      "base_clean_content": "…归一化清洗文本…"
    },
    "wrong_words": {
      "83": ["m", 83, 84, "☰", "外", [0, 617, 349, 46, 58]],
      "121": ["m", 121, 122, "在", "再", [0, 489, 512, 61, 57]],
      "205": ["m", 205, 206, "籍", "藉", [0, 1201, 848, 58, 58]]
    },
    "pangpi": {
      "commit_items": [
        {
          "line": [[[798, 188, 56, 1314, 188, 56]]],
          "commit": "将字迹比作沙砾，又把风声与心神相勾连，用环境烘托烦躁情绪，场景代入感强",
          "position": 46,
          "good_or_bad": "good",
          "origin_sentence": "暖黄的灯光下，作业本的字迹如海边的沙砾，混着窗外萧风扰乱着我的心神",
          "matched_sentence": "暖黄的灯光下,作业本的字迹如海边的沙砾,混着窗外萧风扰乱着我的心神"
        },
        {
          "line": [[[873, 755, 58, 1304, 755, 58]]],
          "commit": "「云鸟共舞」的明快场景和「狼藉」的低落氛围冲突，破坏了此刻的情绪统一",
          "position": 180,
          "good_or_bad": "bad",
          "origin_sentence": "远方青山如黛，云鸟共舞，我却只能独自打扫眼前这片狼藉",
          "matched_sentence": "远方青山如黛,云鸟共舞,我却只能独自打扫眼前这片狼籍"
        }
      ],
      "commit_total": "你擅长用自然景物映射内心世界…若想让文章更有温度，可以试着把海棠的变化和自己具体的成长困境绑定…"
    },
    "pigai": {
      "score": 83,
      "score_items": [
        {"item": "主题立意", "score": 90, "reason": "通过海棠树的变化领悟挫折与新生的关系，立意深刻且贴合主题"},
        {"item": "内容选材", "score": 92, "reason": "以海棠树为核心选材，前后景象对比鲜明，细节生动"},
        {"item": "结构布局", "score": 90, "reason": "按风雨前、风雨后、发现新芽、领悟感悟展开，结构清晰"},
        {"item": "语言表达", "score": 93, "reason": "语言优美生动，运用了比喻、拟人等修辞，画面感强"}
      ],
      "requirements": "这篇作文需紧扣「不错过」的主题，通过具体经历挖掘背后的人生感悟…",
      "outline": "如果我来写这篇文章，开头会用更细腻的环境描写烘托我的烦闷…",
      "title": "不错过生命之树",
      "title_reason": "",
      "first_p": "大雨从天上倒灌而下，狂风夹杂着豆大的雨点，不断拍打着玻璃窗。台灯暖黄的光晕里，作业本上的字迹像沾了潮气的沙砾…",
      "first_p_reason": "修改后加入了「台灯暖黄的光晕」等细节，将作业的烦恼和海棠的处境关联起来…",
      "last_p": "回到房间，我坐下来重新翻开作业本，那些之前像乱麻一样的题目，此刻竟清晰了不少…",
      "last_p_reason": "修改后将感悟和自身生活结合更紧密，强化了主题…",
      "modify": "1. 「混着窗外萧风扰乱着我的心神」搭配不当，可改为「窗外的风声混着心里的烦躁，搅得我心神不宁」；2. …",
      "comment": "这是一篇很有灵气的作文，你用细腻的笔触描绘了海棠树在风雨前后的变化…",
      "paragraphs": [
        "首段用环境描写烘托烦躁心情，将海棠的状态和自身烦恼关联，为下文铺垫情绪。",
        "第二段先渲染风雨后的萧败，再通过转折引出新芽的惊喜，细节描写生动。",
        "第三段从海棠的新生领悟人生道理，将自然景象和人生思考结合，升华主题。",
        "结尾回到自身，呼应开头的烦恼，完成心态转变的闭环。"
      ],
      "highlights": "1. 细节描写生动传神…2. 景与情的交融自然…3. 主题立意深刻…",
      "suggestions": "1. 增加自身与海棠树的关联细节…\n2. 感悟部分可以更贴合自身实际…\n3. 可以在开头或结尾加入海棠的香气描写…",
      "questions": [
        "在观察海棠树新生的时候，你除了看到新芽，还注意到了哪些容易被忽略的细节？",
        "如果把海棠树的新生对应到你生活中的某件事，你觉得最相似的是什么？",
        "如果让你给这篇作文加一个副标题，你会怎么加，为什么？"
      ]
    },
    "runse": {
      "title": "不错过生命之树",
      "content": "大雨从天河倾泻而下，狂风卷着豆大的雨点，狠狠砸向玻璃窗。暖黄的台灯下，作业本上的字迹像沾了潮气的沙砾…\n\n翌日清晨，我早早起身推开院门…\n\n眼前的落红不再让我烦躁…\n\n回到房间，我坐下来重新翻开作业本…",
      "explain": "1. 开篇强化了环境氛围的统一性…\n2. 调整了「云鸟共舞」的违和场景…\n3. 细化了海棠新芽的描写…\n4. 结尾关联自身作业场景，强化「不错过」的主题。"
    },
    "materials_push": null,
    "transmission": {},
    "note": null
  }
}

可选：materials_push 示例

创建时 item 包含 素材推送 且推送成功时，materials_push 可能为：

1
2
3
4
5
6
7
8
9
10
11
12
{
  "weakness_summary": "本次作文主要弱点：景情衔接可更紧密，感悟可更贴合自身经历",
  "materials": [
    {
      "category": "典例",
      "content": "…素材正文 80~150 字…",
      "source": "典故名或出处",
      "target_weakness": "景与情过渡生硬",
      "usage_hint": "可在转折段引用，承上启下"
    }
  ]
}