发送作文批改结果(英语v3)

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

  • 说明:

    • 等级不单独返回,请业务方根据 total_score 自行换算等级。
  • Body:

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

字段名称 类型 默认值 是否可选 说明
version String ‘1’ 传3即可进入本接口

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 英语 v3 批改结果(见下文)
runse object 润色结果

2.1 pigai 字段说明(英语 v3)

字段名 类型 描述
comment string 总评(重点侧重结构,含优缺点与词数信息)
score_items array 维度评分明细(与评分维度列表一致)
total_score int 总分,0~100
highlight_items array 亮点项(结构化)
topic_relevance string 切题程度:切题/部分偏题/偏题
suggestion_items array 提升建议(结构化)

2.2 score_items 子项

字段名 类型 描述
item string 评分维度名称(如:内容、语言准确性、结构与连贯)
score int 该维度分数,0~100
reason string 判分理由(中文)

2.3 highlight_items 子项

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

2.4 suggestion_items 子项

字段名 类型 描述
origin_sentence string 原句(完整句子)
level1_type string 一级错误类型(枚举):词汇/语法/句子
level2_type string 二级错误类型(枚举):’用词’, ‘固定搭配’, ‘词性’, ‘单复数’, ‘冠词’, ‘代词’, ‘指代不清’, ‘介词’,’时态’, ‘主谓一致’, ‘非谓语’, ‘情态动词’, ‘从句’, ‘语态’, ‘虚拟语气’,’平行结构’, ‘倒装’, ‘强调句’, ‘比较结构’, ‘并列结构’, ‘句式’, ‘语序’,’表达不地道’, ‘中式英语’, ‘表达冗余’, ‘衔接’, ‘逻辑’, ‘跑题’, ‘内容不完整’,’成分残缺’, ‘句式杂糅’, ‘连写句’, ‘句子碎片’, ‘段落结构’
new_sentence string 修改后句子
merge_sentence string 修改标记,被修改的内容使用”[]”框柱,修改后的内容被”()”框住。示例:If [you feel lonely because]() you don’t have [](any) close friends, [take it easy.](be relaxed.) You [can take the initiative.](should do it yourself.)
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
{
"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": "本文词数约140词,符合80词的要求。优点是采用了书信的分段结构,有基本的书信格式,针对缺乏自信和学业忙的问题给出了简单的建议。不足是结构连贯性差,段落之间没有呼应不同困扰的逻辑衔接,内容上遗漏了多个核心要点,整体内容不够完整,逻辑也不够清晰。",
"score_items": [{
"item": "内容",
"score": 40,
"reason": "只覆盖了缺乏自信、学业忙没时间发展爱好这两个要点,未涉及学习进步小、被嘲笑、和父母沟通少的内容,要点覆盖不足"
}, {
"item": "语言准确性",
"score": 60,
"reason": "语言表达较简单,存在表达不地道的问题,但基本能传递简单意思,语法错误较少"
}, {
"item": "结构与流畅度",
"score": 50,
"reason": "采用分段式结构,但段落间逻辑关联弱,衔接生硬,没有针对不同困扰的清晰对应板块"
}],
"total_score": 50,
"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. Be courageous."
}],
"topic_relevance": "切题",
"suggestion_items": [{
"reason": "原句表达比较生硬,不符合英语的习惯表达,“do it yourself”指代模糊,不清楚具体要做什么",
"level1_type": "词汇",
"level2_type": "表达不地道",
"new_sentence": "If you feel lonely because you don't have close friends, take it easy. You can take the initiative.",
"merge_sentence": "If [you feel lonely because]() you don't have [](any) close friends, [take it easy.](be relaxed.) You [can take the initiative.](should do it yourself.)",
"origin_sentence": "If you don't have any close friends, be relaxed. You should do it yourself."
}, {
"reason": "原句只给出了规划时间的建议,但没有说明规划时间和提升自信之间的关联,内容不完整,也没有针对自信问题给出更直接的建议",
"level1_type": "内容",
"level2_type": "内容不完整",
"new_sentence": "If you lack confidence, you can start by planning your time carefully to make your study and hobbies more organized, which can help you gain a sense of achievement.",
"merge_sentence": "If you [lack confidence,](feel not confident about yourself,) you can [start by planning](plan) your time [carefully to make your study and hobbies more organized, which can help you gain a sense of achievement.](carefully.)",
"origin_sentence": "If you feel not confident about yourself, you can plan your time carefully."
}, {
"reason": "原句逻辑较跳跃,直接说同学会同意过于绝对,没有体现出主动交流的过程,逻辑不够合理",
"level1_type": "逻辑",
"level2_type": "逻辑",
"new_sentence": "Try to start a conversation with your classmates actively. You can invite them to play football together, and I'm sure you'll get along well and have a good time.",
"merge_sentence": "Try to [start a conversation](speak) with your [classmates actively.](classmates, and they'll chat with you.) You can invite them to play football [together,](too. They can agree,) and [I'm sure you'll get along well and](you will) have a good time.",
"origin_sentence": "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."
}]
},"runse": {}
}