英语作文批改 V3（历史）

一句话说明

英语作文结构化批改版（历史对接）：共用创建接口，传 subject=英语、version=3。
提供百分制总分、固定三维评分、切题判断，以及结构化亮点 / 提升建议。

新对接请优先 英语 V4。版本对照见 英语版本怎么选。
创建入口：创建作文批改

你会得到什么

你要的 在哪里
版本标识 version_name = en_v3
总分 pigai.total_score（0~100）
分项 pigai.score_items（内容 / 语言准确性 / 结构与连贯）
切题 pigai.topic_relevance：切题 / 部分偏题 / 偏题
亮点 pigai.highlight_items
提升建议 pigai.suggestion_items
总评 pigai.comment（中文）

不单独返回等第；如需等级请自行按总分换算。

如何启用

字段 取值
subject 英语
version 3

计费

约 1 次 / 0.2 元。

pigai 重点字段

score_items

字段 说明
item 维度名
score 0~100
reason 中文理由

highlight_items

字段 说明
origin_sentence 原句（英文）
reason 亮点理由（中文）

suggestion_items

字段 说明
origin_sentence 原句
level1_type 一级类型：词汇 / 语法 / 句子
level2_type 更细的错误类型
new_sentence 修改后句子
merge_sentence 一行内对比标记（见下）
reason 建议说明（中文）

merge_sentence 标记规则：

  • 替换：{@新内容@}
  • 删除：``
  • 新增：{@新内容@}

示例：If {@you feel lonely@} you don't have close friends

请求示例

1
2
3
4
5
6
7
8
9
10
11
{
  "subject": "英语",
  "version": 3,
  "grade": "初二",
  "title": "My Weekend Plan",
  "topic_content": "Write about your weekend plan.",
  "images": [
    { "url": "https://example.com/en3.jpg", "width": 864, "height": 1920 }
  ],
  "callback_url": "https://partner.example.com/callback"
}

结果短示例

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
{
  "pigai": {
    "total_score": 72,
    "topic_relevance": "切题",
    "comment": "结构基本清楚，内容可再补全题干要点……",
    "score_items": [
      { "item": "内容", "score": 70, "reason": "要点覆盖一般" },
      { "item": "语言准确性", "score": 75, "reason": "有少量语法问题" },
      { "item": "结构与连贯", "score": 72, "reason": "衔接词偏少" }
    ],
    "highlight_items": [
      { "origin_sentence": "I enjoy playing basketball with my friends.", "reason": "表达自然" }
    ],
    "suggestion_items": [
      {
        "origin_sentence": "I am go to park.",
        "level1_type": "语法",
        "level2_type": "时态错误",
        "new_sentence": "I am going to the park.",
        "merge_sentence": "I am {#go#}{@going@} to {@the @}park.",
        "reason": "注意进行时形态"
      }
    ]
  }
}

对接检查清单

  1. 是否按 total_score（不是 score）取总分
  2. merge_sentence 标记是否已正确渲染
  3. 新业务是否应升级到 V4（score + score_detail + 等第）

关联文档

主题 文档
创建接口 创建作文批改
回调 发送作文批改结果
新对接首选 英语 V4