英语作文批改 V1

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

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

如何启用本版本

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

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

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

版本特点

对比项 V1（本版本） V2 V3 V4
侧重点 综合批改 + 单篇润色 更侧重改错（mod_items） 综合批改（结构同通用回调） 高级评分 + 书写规范等
润色 单篇 runse 单篇 runse 单篇 runse 单篇 runse
strictness 不生效 不生效 不生效 生效
新对接推荐 历史默认 历史对接 历史对接 首选

请求与响应

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

对接时重点关注：

  • item、score_items：与语文标准版相同语义，按英语场景配置批改维度
  • words_count：作文字数要求；仅 V4 参与专用字数扣分规则，V1 按通用逻辑处理
  • 提交成功返回 data.id，批改结果通过 callback_url 推送

升级选型

回调 / 详情 data 字段总览

批改完成后的回调 Body 与 查询作文详情 返回的 data 结构一致。V1 固定 version_name = en_v1。

字段 类型 说明
zuowen_id string 作文任务 ID
version_name string 固定 en_v1
status number 1=完成，-1=失败（详情接口可见）
title string 识别后的作文标题（英文）
content string OCR 纠错前正文
correct_words string OCR 纠错后正文
ocr_text object 含 img_list、坐标等，详见《发送作文批改结果》
wrong_words object 错词/拼写，结构同语文
pangpi object 旁批；commit 等为中文，origin_sentence 为英文
pigai object 综合批改，字段随 item 动态返回（见下节）
runse object 单篇润色：title/content 为英文，explain 为中文
transmission object 创建时透传字段
note object | null 内部备注

英语 V1 不会返回：mod_items / more_items（V2）、highlight_items / suggestion_items / topic_relevance（V3）、score_detail（V4）。
英语 V1 不支持 materials_push（仅语文）。

pigai 字段说明（V1 标准版）

英语 V1 与 语文 V1 共用同一套 pigai 结构：AI 直评 + 可选维度评分。说明性字段（如 comment、modify、各 *_reason）为中文；涉及改写示例的 first_p / last_p / title 等为英文。

字段 类型 触发条件（item） 说明
score int 含 评分 总分 0~100；会按错词比例、字数比例扣减
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 含 修改错误 语法/用词等修改说明（中文，忽略拼写 OCR 错）
comment string 含 评语 总评（中文）
paragraphs array 含 段评 逐段点评（中文）
highlights string 含 亮点 亮点（中文）
suggestions string 含 不足和建议 改进建议，多条用 \n 分隔（中文）
questions array 含 提问 引导思考的问题（中文）

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

字段 类型 说明
title string 润色后英文标题
content string 润色后英文正文，段落用 \n 分隔，词数与原文接近
explain string 润色说明（中文），按序号说明修改点

完整回调 JSON 示例（en_v1）

以下为典型成功回调。ocr_text 仅保留结构示意；pigai / pangpi / runse 为 V1 标准版完整字段形态（非 V2 的 mod_items）。

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
104
105
106
107
108
{
  "code": 1,
  "msg": "批改成功",
  "data": {
    "zuowen_id": "QhLVKwo",
    "version_name": "en_v1",
    "status": 1,
    "createtime": 1766741866,
    "company_id": 4,
    "title": "A Letter to My Friend",
    "content": "Dear Tom,\n  If you feel not confident about yourself, you can plan your time carefully. What about make a list of all things you need to do? And enjoy your hobbies according to the time you have. For example, play football or basketball if you have a lot of time. Listen to music if you have short time.\n  If you don't have any close friends, be relaxed. You should do it yourself. Try to speak with your classmates, and they'll chat with you. You can invite them to play football too. They can agree, and you will have a good time.\n  I think you can do anything if you try your best. Be courageous, and these problems will be solved.\nBest wishes,\nLi Hua",
    "correct_words": "Dear Tom,\n  If you feel not confident about yourself, you can plan your time carefully. What about making a list of all things you need to do? And enjoy your hobbies according to the time you have. For example, play football or basketball if you have a lot of time. Listen to music if you have a short time.\n  If you don't have any close friends, be relaxed. You should do it yourself. Try to speak with your classmates, and they'll chat with you. You can invite them to play football too. They can agree, and you will have a good time.\n  I think you can do anything if you try your best. Be courageous, and these problems will be solved.\nBest wishes,\nLi Hua",
    "ocr_text": {
      "img_list": [
        {
          "url": "https://example.com/en-composition.jpg",
          "width": 864,
          "height": 1920,
          "columns": [
            {
              "left": 72,
              "right": 1343,
              "column": [
                [
                  ["If", 72, 7, 64, 295],
                  ["you", 140, 7, 64, 295]
                ]
              ]
            }
          ]
        }
      ],
      "origin_content": "…OCR 原始文本…",
      "base_clean_content": "…清洗文本…"
    },
    "wrong_words": {},
    "pangpi": {
      "commit_items": [
        {
          "line": [[[366, 76, 93, 1343, 77, 93]]],
          "commit": "用「What about」提建议很自然，但后接动词需用 ing 形式，改为 making 更符合语法",
          "position": 75,
          "good_or_bad": "bad",
          "origin_sentence": "What about making a list of all things you need to do",
          "matched_sentence": "What about make a list of all things you need to do"
        },
        {
          "line": [[[128, 487, 70, 1307, 493, 70]]],
          "commit": "结尾鼓励的话很温暖，传递了积极态度；若结合朋友具体困扰会更贴合主题",
          "position": 505,
          "good_or_bad": "good",
          "origin_sentence": "I think you can do anything if you try your best",
          "matched_sentence": "I think you can do anything if you try your best"
        }
      ],
      "commit_total": "你的作文结构清晰，从时间规划、交友到鼓励朋友，覆盖了部分问题。建议更具体，并注意语法细节…"
    },
    "pigai": {
      "score": 72,
      "score_items": [
        {
          "item": "内容",
          "score": 68,
          "reason": "覆盖了缺乏自信、交友等要点，但未充分回应题干中与父母沟通、学习进步等核心内容"
        },
        {
          "item": "语言准确性",
          "score": 70,
          "reason": "存在 What about make、short time 缺冠词等语法问题，表达偏生硬"
        },
        {
          "item": "结构与连贯",
          "score": 75,
          "reason": "分段清晰，但段间衔接词较少，个别句子逻辑可更紧密"
        }
      ],
      "requirements": "本题要求以书信形式给朋友提建议，需覆盖题干中的多个困扰点…",
      "outline": "若我来写：开头点明写信目的；中间分「时间管理」「交友」「与父母沟通」三段…",
      "title": "A Letter to My Troubled Friend",
      "title_reason": "原标题过短且未体现书信安慰朋友的语境",
      "first_p": "Dear Tom,\n  I know you've been feeling down lately because of school pressure and loneliness. I'd like to share some ideas that might help.",
      "first_p_reason": "补充了写信对象与安慰语境，使开头更贴合书信体裁",
      "last_p": "Remember, small steps count. Talk to your parents when you feel stressed—they care about you. Best wishes!\nLi Hua",
      "last_p_reason": "结尾补充与父母沟通的建议，呼应题干遗漏要点",
      "modify": "1. What about 后接动名词：make → making；2. short time 前加 a；3. do it yourself 表意模糊，可改为 take the first step to talk to classmates",
      "comment": "本文采用书信分段结构，能针对朋友缺乏自信、交友困难给出具体建议，语言简单易懂。但词数偏少，未覆盖题干全部要点，语法有小错误，内容完整性需加强。",
      "paragraphs": [
        "第一段：时间管理建议，举例较具体。",
        "第二段：交友建议，行动指引偏笼统。",
        "第三段：鼓励收束，可再呼应题干其他困扰。"
      ],
      "highlights": "1. 用 for example 给出可操作的爱好安排；2. 结尾 Be courageous 传递积极态度。",
      "suggestions": "1. 补充与父母沟通的段落…\n2. 将 do it yourself 改为更具体的交友步骤…\n3. 增加过渡词使段间更连贯…",
      "questions": [
        "如果朋友回复说「和父母说不出口」，你还会建议他怎么做？",
        "除了踢足球，还有哪些适合在课间开展的交友方式？",
        "你会如何衡量这篇建议信是否真正「切题」？"
      ]
    },
    "runse": {
      "title": "A Letter to My Troubled Friend",
      "content": "Dear Tom,\n  I know you've been feeling down lately. If you feel not confident about yourself, you can plan your time carefully. What about making a list of all the things you need to do? Enjoy your hobbies according to the time you have. For example, play football or basketball if you have a lot of time, or listen to music if you have a short time.\n  If you don't have any close friends, don't be nervous. You can take the first step to talk to your classmates, and they'll chat with you. You can invite them to play football too. They might agree, so you will have a good time.\n  I think you can do anything if you try your best. Also, talk to your parents about your stress—they care more than you think. Be courageous, and these problems will be solved.\nBest wishes,\nLi Hua",
      "explain": "1. 修正 What about make → making、short time → a short time 等语法问题；\n2. 将 do it yourself 改为 take the first step，建议更具体；\n3. 补充 talk to your parents，呼应题干要点；\n4. 用词控制在初中常见范围，未使用超纲难词。"
    },
    "transmission": {},
    "note": null
  }
}

对接提示：判断版本时读取 data.version_name === 'en_v1'；若看到 mod_items，说明实际走的是 英语 V2（version=2），而非 V1。