英语作文批改 V4（推荐）

一句话说明

英语作文新对接首选：共用创建接口，传 subject=英语、version=4。
提供按学段区分的等级制评分（含等第）、书写规范、词数扣分，以及结构化亮点与提升建议。说明文字为中文，示例句保持英文。
版本怎么选见 英语版本怎么选。

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

你会得到什么

你要的 在哪里 说明
版本标识 version_name en_v4
总分 pigai.score 初中建议满分 15，高中建议满分 25
评分详情 pigai.score_detail 等第、维度等级、可选字数扣分等
切题 pigai.topic_relevance 切题 / 部分偏题 / 偏题
总评 pigai.comment 中文
亮点 / 建议 highlight_items / suggestion_items 结构与 V3 同类
旁批 / 错别字 / 润色 通用字段 见回调总览

相对 V3：用 score + score_detail 替代 total_score + 顶层 score_items；score_detail 内仍有扁平 score_items 便于兼容。

如何启用

字段 取值
subject 英语
version 4
words_count 建议填写要求词数（参与字数扣分）
strictness 可选：lenient / normal / strict
grade 影响学段满分与维度（初中 / 高中）

与其他英语版本比

完整对照见 英语版本怎么选。相对 V3：本版用 score + score_detail（等第、字数扣分、书写规范等），计费仍约 0.2 元 / 1 次。

计费

扣费方式 扣减
次数余额 1 次
金额余额 20 分（0.2 元）

is_pro=1 时走 Pro 次数账户，单价按 Pro 约定。

评分松紧（strictness）

取值 概括
lenient 对轻微语法拼写更宽容，发展维度给分更积极
normal 默认
strict 对错误更敏感，亮点认定更克制

不传按 normal。

score_detail 怎么读

字段 说明
总分 与 pigai.score 一致
满分 初中 15 / 高中 25（按年级）
等第 一类文 / 二类文 / 三类文 / 四类文
ai_score 百分制参考分（0~100），便于精细比较
score_items 扁平维度列表（等级 A/B/C/D）
基础等级评分 / 发展等级评分 分组明细
通用评分 可能含「书写规范」
评语概要（教师参考） 综合概要
字数扣分 可选；仅实际词数低于要求词数 90% 时出现

学段维度（score_items）

初中（年级 ≤ 9，满分 15）

类型 维度
基础等级 内容任务完成度、语言语法准确性、词汇运用恰当性、篇章结构规范性
发展等级 句式丰富度、衔接与连贯性、语言地道性、拼写与文本规范

高中（年级 > 9，满分 25）

类型 维度
基础等级 内容切题与充实度、语法规范与准确性、词汇准确与丰富度、篇章结构与格式
发展等级 句式高级与多样性、衔接与逻辑严谨性、语言地道与得体性、思维与文采亮点、拼写与文本规范

扁平 score_items 单项常见字段：item / score(A~D) / reason / evidence / level_type。

字数扣分规则

创建时填写了 words_count（要求词数）时：

实际词数 处理
≥ 要求词数 不扣
≥ 要求词数的 90% 不扣
< 90% 按比例扣；此时才返回 字数扣分 对象

字数扣分 常见子字段：实际词数、要求词数、扣分前得分、扣分后得分。

书写规范

score_detail.通用评分 中可能出现「书写规范」（满分 5）。
若识别到较多涂改 / 删除痕迹，可能对总分做小幅下调（最多约 5%）。无字符级坐标的特殊识别场景下通常不扣。

suggestion_items / highlight_items

与 英语 V3 同类：

  • highlight_items：origin_sentence + reason
  • suggestion_items：含 level1_type / level2_type / new_sentence / merge_sentence 等
  • merge_sentence 标记：{@新@} / `` / {@新@}

请求示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "subject": "英语",
  "version": 4,
  "grade": "初二",
  "title": "A Letter of Advice",
  "topic_content": "Write a letter to give advice. At least 80 words.",
  "words_count": 80,
  "total_score": 15,
  "strictness": "normal",
  "images": [
    { "url": "https://example.com/en4.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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
{
  "code": 1,
  "msg": "批改成功",
  "data": {
    "zuowen_id": "u3EDmPW",
    "version_name": "en_v4",
    "status": 1,
    "pigai": {
      "score": 10,
      "topic_relevance": "切题",
      "comment": "结构基本清楚，内容要点可再补全……",
      "score_detail": {
        "总分": 10,
        "满分": 15,
        "等第": "二类文",
        "ai_score": 66.8,
        "score_items": [
          {
            "item": "内容任务完成度",
            "score": "B",
            "reason": "基本完成任务，部分要点未覆盖",
            "evidence": null,
            "level_type": "基础等级"
          }
        ],
        "基础等级评分": [],
        "发展等级评分": [],
        "通用评分": [
          {
            "维度": "书写规范",
            "等级": "A",
            "得分": 5,
            "总分": 5,
            "理由": ""
          }
        ]
      },
      "highlight_items": [],
      "suggestion_items": []
    }
  }
}

对接检查清单

  1. version=4，grade 是否正确（影响满分与维度）
  2. 是否用 pigai.score（不是 V3 的 total_score）展示总分
  3. 是否填写 words_count，并兼容无 字数扣分 字段的情况
  4. 是否需要 strictness
  5. suggestion_items.merge_sentence 是否已正确渲染
  6. 计费按标准价 0.2 元预留，不要按 0.3 元估算

关联文档

主题 文档
版本对照 英语版本怎么选
创建接口 创建作文批改
回调 发送作文批改结果
历史结构化版 英语 V3
接口索引 接口总览索引