发送作文批改结果（英语v4）

当作文为英语且使用 v4 批改方案时，平台会将批改结果推送到业务方回调地址。

  • 说明：

    • V4 在 V3 基础上升级了评分体系：评分由独立评分模块完成，采用”基础等级 + 发展等级”双轨评分，按学段（初中/高中）使用不同的评分维度和满分，评分结果更加细致和稳定；
    • 批改反馈部分（comment、suggestion_items、highlight_items）与 V3 一致；
    • V4 结果依旧通过《发送作文批改结果》中约定的回调方式下发，pigai 字段结构在 V3 的基础上用 score + score_detail 替换了原来的 total_score + score_items；score_detail 内同时提供了 score_items 扁平列表以兼容 V3 消费方式；
    • 回调结果与详情查询中会返回 data.version_name = 'en_v4'，便于区分英语 V4 版本；
    • 所有说明性文字（如 comment、reason、评分理由）统一为中文，示例句保持英文原文；
    • 计费说明：V4 采用高级评分，每次批改消耗 1.5 次（按次数扣减时）或 0.3 元（按金额扣减时）。

  • 与 V3 的主要区别：

对比项 V3 V4
评分方式 AI 批改时内嵌评分（total_score + score_items） 独立评分模块（score + score_detail），双轨评分
评分维度 内容、语言准确性、结构与连贯（固定3项，百分制） 按学段区分：基础等级4项 + 发展等级4~5项，ABCD 等级制
score_items item / score(百分制) / reason item / score(ABCD) / reason / evidence / level_type，位于 score_detail 内
总分 百分制（0~100） 按学段：建议初中满分15分，高中满分25分
等第 不返回，需业务方自行换算 直接返回（一类文/二类文/三类文/四类文）
批改反馈 comment / suggestion_items / highlight_items 与 V3 一致
  • Body：

在创建作文基础上，当subject=英语时，可以传version=4。其他字段参考创建作文

字段名称 类型 默认值 是否可选 说明
version String ‘1’ 是 传4即可进入本接口
strictness String null 是 评分宽松度，可选值：lenient（宽松）、normal（标准，默认）、strict（严苛）。不传或传空时按 normal 处理。宽松档对轻微语法拼写更宽容、发展维度给分更积极；严苛档对错误更敏感、亮点认定更克制

1. 请求信息

  • HTTP 方法：post
  • 请求地址：
    1
    https:回调URL

2. 请求参数（顶层）

字段名 类型 描述
ocr_text object OCR 识别结果
pangpi object 旁批结果
title string 作文标题
content string 原始作文内容
wrong_words object 错词信息
correct_words string 纠错后文本
pigai object 英语 v4 批改结果（见下文）
runse object 润色结果

2.1 pigai 字段说明（英语 v4）

字段名 类型 描述
comment string 总评（重点侧重结构，含优缺点与词数信息）
score int 总分（按学段：初中 015，高中 025）
score_detail object 评分详情（见 2.2）
highlight_items array 亮点项（见 2.5）
topic_relevance string 切题程度：切题/部分偏题/偏题
suggestion_items array 提升建议（见 2.6）

2.2 score_detail 评分详情

字段名 类型 描述
总分 int 作文得分（与 pigai.score 一致）
满分 int 该学段满分（初中15，高中25）
等第 string 等第：一类文/二类文/三类文/四类文
ai_score float AI 百分制原始得分（0~100），用于精细比较
score_items array 扁平化的维度评分列表，兼容 V3 格式（见 2.3）
基础等级评分 array 基础维度评分明细（见 2.4）
发展等级评分 array 发展维度评分明细（见 2.4）
通用评分 array 保留字段，当前为空数组
评语概要（教师参考） string 综合评语概要，供教师参考

2.3 score_items 子项

字段名 类型 描述
item string 评分维度名称（与基础/发展等级评分中的”维度”一致）
score string 等级：A/B/C/D（A 最优，D 最差）
reason string 该维度的评分理由（中文）
evidence string 原文中支撑该评级的证据片段（可能为 null）
level_type string 所属等级类型：基础等级 / 发展等级
  • score_items 中的 item 按学段不同：

初中（grade <= 9，满分15分）— 共 8 项：

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

高中（grade > 9，满分25分）— 共 9 项：

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

2.4 评分维度子项（基础等级评分 / 发展等级评分）

字段名 类型 描述
维度 string 评分维度名称
等级 string A/B/C/D（A 最优，D 最差）
理由 string 该维度的评分理由（中文）
证据 string 原文中支撑该评级的证据片段（可能为空）
  • 评分维度按学段不同：

初中（grade <= 9，满分15分）：

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

高中（grade > 9，满分25分）：

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

2.5 highlight_items 子项

字段名 类型 描述
origin_sentence string 原句（完整句子）
reason string 亮点理由（正向引导）

2.6 suggestion_items 子项

字段名 类型 描述
origin_sentence string 原句（完整句子）
level1_type string 一级错误类型（枚举）：词汇/语法/句子
level2_type string 二级错误类型（枚举）:’词汇’: [
‘用词不当’, ‘固定搭配错误’, ‘词汇层面中式英语’, ‘词汇层面表达不地道’,
‘词汇冗余’, ‘单词拼写错误’, ‘易混词误用’
],
‘语法’: [
‘词性误用’, ‘名词单复数错误’, ‘冠词误用’, ‘代词误用’, ‘介词语法误用’,
‘时态错误’, ‘主谓一致错误’, ‘非谓语动词错误’, ‘情态动词误用’, ‘语态错误’, ‘虚拟语气错误’,
‘从句使用错误’, ‘指代不明’, ‘平行结构错误’, ‘并列结构错误’, ‘倒装结构错误’,
‘强调句结构错误’, ‘比较结构错误’, ‘语序错误’, ‘句子成分残缺’, ‘句式杂糅’
],
‘句子’: [
‘句式选用不当’, ‘句间衔接不当’, ‘句子逻辑混乱’, ‘中式英语’,
‘表达不地道’, ‘句子冗余’, ‘句子歧义’, ‘句式语体不当’]
new_sentence string 修改后句子
merge_sentence string 修改标记，便于在一行内直观看到"原句 vs 修改后句子"的差异（旧内容在前，新内容在后），规则为：
• 替换：`{#旧内容#}{@新内容@}`；
• 删除：`{#旧内容#}`；
• 新增：`{@新内容@}`。
示例：If {@you feel lonely because@} you don't have {#any#} close friends, {#be relaxed.#}{@take it easy.@} You {#should do it yourself.#}{@can take the initiative.@}
reason string 修改理由/建议（语气温和、正向）

3. 返回响应

回调接口需返回业务方的接收结果，建议：

字段 类型 必选 示例 解释
code number 是 1 1=接收成功，0=接收失败
msg string 否 ok 提示信息

4. 示例

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
109
110
111
112
{
	"ocr_text": {},
	"pangpi": {},
	"wrong_words": {},
	"title": "My Weekend Plan",
	"content": "I am go to park with my friend...",
	"correct_words": "I am going to the park with my friend...",
	"pigai": {
		"comment": "本文采用书信分段结构，有基本的逻辑分层，优点是能针对缺乏自信、学业与爱好平衡给出具体的小建议，语言简单易懂。但文章词数约130词，存在明显的内容缺失，未覆盖学习进步、被他人嘲笑、与父母沟通这三个核心要点，且段落间缺少自然的衔接词，整体连贯性有待提升，内容的完整性亟需加强。",
		"topic_relevance": "切题",
		"score": 10,
		"score_detail": {
			"总分": 10,
			"满分": 15,
			"等第": "二类文",
			"ai_score": 66.8,
			"通用评分": [],
			"score_items": [
				{"item": "内容任务完成度", "score": "B", "reason": "基本完成写信任务，能围绕缺乏自信和学业与爱好平衡展开建议，但学习进步、被嘲笑和与父母沟通等要点未涉及，内容存在较明显缺漏。", "evidence": "文中仅讨论了自信和时间规划两个方面，未提及学习进步、被嘲笑、与父母沟通。", "level_type": "基础等级"},
				{"item": "语言语法准确性", "score": "B", "reason": "整体语法控制尚可，能写出较清晰的简单句和少量复合句，但存在部分表达不够精确的问题。", "evidence": null, "level_type": "基础等级"},
				{"item": "词汇运用恰当性", "score": "C", "reason": "词汇较为基础，选词重复较多，搭配偶有不够贴切之处，表达层次一般。", "evidence": "多次使用 can/you can 结构，缺少词汇变化。", "level_type": "基础等级"},
				{"item": "篇章结构规范性", "score": "B", "reason": "有书信基本格式，段落有一定分层，但段间过渡略显生硬，衔接词使用不足。", "evidence": null, "level_type": "基础等级"},
				{"item": "句式丰富度", "score": "C", "reason": "以简单句和基础 if 条件句为主，复杂句尝试较少，句式变化有限。", "evidence": "全文主要使用 You can... / If you... 句型。", "level_type": "发展等级"},
				{"item": "衔接与连贯性", "score": "C", "reason": "段落间缺少自然的连接词和过渡句，跳跃感较明显。", "evidence": null, "level_type": "发展等级"},
				{"item": "语言地道性", "score": "C", "reason": "存在部分中式表达和不够自然的句段，如 be relaxed 用法不够地道。", "evidence": "be relaxed 作为安慰用语不够自然。", "level_type": "发展等级"},
				{"item": "拼写与文本规范", "score": "B", "reason": "拼写基本准确，大小写和标点规范，文本格式尚可。", "evidence": null, "level_type": "发展等级"}
			],
			"基础等级评分": [
				{
					"维度": "内容任务完成度",
					"等级": "B",
					"理由": "基本完成写信任务，能围绕缺乏自信和学业与爱好平衡展开建议，但学习进步、被嘲笑和与父母沟通等要点未涉及，内容存在较明显缺漏。",
					"证据": "文中仅讨论了自信和时间规划两个方面，未提及学习进步、被嘲笑、与父母沟通。"
				},
				{
					"维度": "语言语法准确性",
					"等级": "B",
					"理由": "整体语法控制尚可，能写出较清晰的简单句和少量复合句，但存在部分表达不够精确的问题。",
					"证据": null
				},
				{
					"维度": "词汇运用恰当性",
					"等级": "C",
					"理由": "词汇较为基础，选词重复较多，搭配偶有不够贴切之处，表达层次一般。",
					"证据": "多次使用 can/you can 结构，缺少词汇变化。"
				},
				{
					"维度": "篇章结构规范性",
					"等级": "B",
					"理由": "有书信基本格式，段落有一定分层，但段间过渡略显生硬，衔接词使用不足。",
					"证据": null
				}
			],
			"发展等级评分": [
				{
					"维度": "句式丰富度",
					"等级": "C",
					"理由": "以简单句和基础 if 条件句为主，复杂句尝试较少，句式变化有限。",
					"证据": "全文主要使用 You can... / If you... 句型。"
				},
				{
					"维度": "衔接与连贯性",
					"等级": "C",
					"理由": "段落间缺少自然的连接词和过渡句，跳跃感较明显。",
					"证据": null
				},
				{
					"维度": "语言地道性",
					"等级": "C",
					"理由": "存在部分中式表达和不够自然的句段，如 be relaxed 用法不够地道。",
					"证据": "be relaxed 作为安慰用语不够自然。"
				},
				{
					"维度": "拼写与文本规范",
					"等级": "B",
					"理由": "拼写基本准确，大小写和标点规范，文本格式尚可。",
					"证据": null
				}
			],
			"评语概要（教师参考）": "文章能围绕部分要点展开，语言基本准确但词汇较为单薄，建议增加要点覆盖面，丰富句式表达，加强段间衔接。"
		},
		"highlight_items": [
			{
				"reason": "用具体的例子说明如何利用碎片时间发展爱好，建议清晰且贴近学生生活，增强了内容的实用性",
				"origin_sentence": "For example, play football or basketball if you have a lot of time. Listen to music if you have a short time."
			},
			{
				"reason": "结尾用鼓励性的话语收束全文，传递积极正向的态度，符合书信安慰朋友的语境",
				"origin_sentence": "I think you can do anything if you try your best."
			}
		],
		"suggestion_items": [
			{
				"reason": "原句中"不自信"和"规划时间"逻辑关联较弱，建议先建立自信的具体方法再衔接时间规划，让逻辑更顺畅",
				"level1_type": "句子",
				"level2_type": "句子逻辑混乱",
				"new_sentence": "If you feel unconfident about yourself, you can learn to recognize your small progress first and make a reasonable time plan.",
				"merge_sentence": "If you feel {#not confident#}{@unconfident@} about yourself, you can {#plan#}{@learn to recognize@} your {@small progress first and make a reasonable@} time {#carefully.#}{@plan.@}",
				"origin_sentence": "If you feel not confident about yourself, you can plan your time carefully."
			},
			{
				"reason": "原句中 do it yourself 表意模糊，不符合交朋友的语境，替换为具体的行动建议更贴合主题",
				"level1_type": "词汇",
				"level2_type": "用词不当",
				"new_sentence": "If you feel lonely because you don't have close friends, don't be nervous. You can take the first step to communicate with others.",
				"merge_sentence": "If {@you feel lonely because@} you don't have {#any#} close friends, {@don't@} be {#relaxed.#}{@nervous.@} You {#should do it yourself.#}{@can take the first step to communicate with others.@}",
				"origin_sentence": "If you don't have any close friends, be relaxed. You should do it yourself."
			}
		]
	},
	"runse": {}
}