创建带高级评分功能的语文作文批改

接口描述

  • 提交一篇语文作文进行后台批改，并使用高级评分系统独立完成评分
  • 批改流程与标准版一致，评分环节由高级评分系统替代标准版 AI 直评

高级评分 vs 标准评分

对比项 标准版（《创建作文批改》） 高级评分（本接口）
评分方式 AI 输出分数 独立评分系统
评分维度 由 score_items 参数自定义 不支持自定义，系统内置
评分粒度 单项 0-100 分 每维度 A/B/C/D 等级，加权折算为总分
偏题检测 无 自动判断任务符合度，偏题作文自动限分
结果位置 pigai.score + pigai.score_items pigai.score + pigai.score_detail
适用学科 语文 / 英语 仅语文

注意事项

  • . 仅支持语文，英语作文请使用标准版或 V2/V3 接口
  • . 文体类别，必须传正确的文体（题目要求的文体类别，尽量细分，比如能判断是【写人为主的记叙文】就不要填【记叙文】。只有文体不限、多个文体的情况下，才可以填【不限】
  • . item 中无需包含 评分，即使传入也会被忽略，评分由高级评分系统独立完成
  • . score_items 字段无效，评分维度由系统确定
  • . 回调结果与详情查询中会返回 data.version_name = 'cn_v2'，便于区分语文高级评分版本
  • . 其余注意事项与标准版一致：
    • AI评分具有主观性，仅供参考
    • 图片质量差（如含大片深色内容）可能导致识别失败
    • 内容含敏感词（政治、色情、暴力等）将无法批改
    • OCR 识别有效文字内容过少（约小于30字）将视为识别失败
    • OCR识别文字效果不佳（错误率超过85%）将直接返回”不予批改” ，可以重新剪裁、拍照后提交
    • 错误码说明可参考《开放平台说明》中”作文批改相关业务错误码说明”

请求说明

  • HTTP 方法：post
  • 请求地址
    1
    https://api.21days.cloud/opi/p/c012/create_zuowen
  • URL参数：无
  • Header：accessToken鉴权
  • Body：
字段名称 类型 默认值 是否可选 说明
subject String ‘语文’ 否 固定传 语文（本接口仅支持语文）
total_score Number 100 否 作文总分（只能设为100，按比例换算用户设定分值）
words_count Number 400 否 作文字数要求
grade String ‘四年级’ 否 适用年级（如’三年级’、’九年级’、’初二’）
writing_type String ‘不限’ 是 作文类型,枚举：不限/记叙文/写景为主的记叙文/写人为主的记叙文/叙事为主的记叙文/状物为主的记叙文/抒情为主的记叙文/说明文/想象作文/推荐文/议论文/应用文/剧本/日记/散文/诗歌/书信/倡议书/读后感
title String ‘题目自拟’ 是 作文标题，若留空需通过题干明确主题
topic_content String ‘’ 是 作文题干，描述写作要求、主题等核心指引。建议填写，用于偏题检测判断
correct_standard String ‘’ 是 评分标准（包含内容、结构、语言等维度，支持自定义）
images Array [] 是 作文原图URL列表（示例：[{"url":"...","width":864,"height":1920}]）
要求：图片需剪裁避免深色内容，公开可访问，格式为jpg/jpeg/png/bmp，单图≤4M，最长边≤4096px
item Array [] 是 批改结果类型，支持：改写标题、改写开头结尾、修改错误、评语、段评、亮点、写作要求、写作思路、不足和建议、提问、精简批改。
评分 会被自动忽略
version String — 否 固定传 2，标识使用高级评分系统

响应说明

字段 类型 必选 示例 解释
code Number 是 1 1=正常，0=异常，-1=未登录
msg String 否 “创建成功” 提示信息
data object 否 {“id”: “u3EDmPW”} 核心数据（作文ID）

  • 提交成功后会立即返回作文ID，后台异步执行批改 + 高级评分流程

  • 联调建议：

    • 服务端需确保 callback_url 在 3 秒内可返回 HTTP 200，任何非 200 状态码都会视为未收到结果；
    • 平台会按约 3 秒一次的频率最多重试 10 次，成功收到 200 后不再重试；
    • 批改相关字段（ocr_text、pangpi、wrong_words、pigai、runse 等）的通用结构详见《发送作文批改结果》；
    • 评分结果位于 pigai.score 和 pigai.score_detail，结构见下文。

回调结果中的评分字段

批改完成后，回调的 data.pigai 对象会包含以下评分相关字段：

字段名 类型 描述
score int 作文总评分（已折算到 total_score 分制）
score_detail object 高级评分详情，包含维度化评分、偏题检测等完整信息

pigai 中其余字段（comment、title、first_p、last_p、modify、outline、highlights、paragraphs、suggestions、requirements、questions 等）与标准版一致，详见《发送作文批改结果》。
高级评分模式下 pigai 中不会有 score_items 字段，而是换成 score_detail 字段进行区分。

score_detail 对象结构

字段名 类型 描述
总分 int 总分（100分制），已考虑字数和偏题扣减
等第 string 等第判定：一类文 / 二类文 / 三类文 / 四类文
zongfen int 满分分值（与创建作文时传入的 total_score 一致）
ai_score number AI 维度评分原始得分
任务符合度 string 作文与题目的符合程度：符合 / 大部分符合 / 少部分符合 / 不符合
偏题理由 string 偏题判断依据（可为 null）
偏题证据 string 偏题证据原文引用（可为 null）
基础等级评分 array 基础等级维度评分列表
发展等级评分 array 发展等级维度评分列表
通用评分 array 通用评分列表（字数、错别字等）

基础等级评分 / 发展等级评分 数组元素

每个元素代表一个评分维度：

字段名 类型 描述
维度 string 维度名称（如：审题与聚焦、中心与完整、语言与规范等）
等级 string A / B / C / D
权重占比 number 该维度在总分中的权重（0-1之间，所有维度权重之和为1）
理由 string 判断依据
证据 string 作文原文关键句引用（可为 null，全局性维度可能无证据）



完整回调示例

以下为回调 Body 中 data 内 pigai 对象的评分相关部分示例（其余批改字段省略，详见《发送作文批改结果》）：

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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
{
  "code": 1,
  "msg": "批改成功",
  "data": {
    "zuowen_id": "mSO9Ilx",
    "status": 1,
    "ocr_text": { "...": "省略，结构参见《发送作文批改结果》" },
    "title": "李晓明过生日",
    "content": "一天，校园里同学们一起欢乐地讨论着与家人一起过的生日...",
    "wrong_words": { "...": "省略" },
    "correct_words": "...",
    "pangpi": { "...": "省略" },
    "pigai": {
      "score": 74,
      "score_detail": {
        "总分": 74,
        "等第": "三类文",
        "满分": 100,
        "任务符合度": "符合",
        "偏题理由": "作文围绕为李晓明过生日展开，符合题目要求",
        "偏题证据": null,
        "基础等级评分": [
          {
            "维度": "审题与聚焦",
            "等级": "A",
            "得分": 10,
            "总分": 10,
            "权重占比": 0.09,
            "理由": "全文紧密围绕主题展开",
            "证据": "校园里同学们一起欢乐地讨论着与家人一起过的生日"
          },
          {
            "维度": "中心与完整",
            "等级": "B",
            "得分": 8,
            "总分": 10,
            "权重占比": 0.14,
            "理由": "中心明确，但结尾环节较简略",
            "证据": "于是军军和婷婷一起讨论该怎么办"
          },
          {
            "维度": "内容与经过",
            "等级": "C",
            "得分": 6,
            "总分": 10,
            "权重占比": 0.19,
            "理由": "经过简略，缺乏具体情节展开",
            "证据": null
          },
          {
            "维度": "结构与顺序",
            "等级": "B",
            "得分": 8,
            "总分": 10,
            "权重占比": 0.09,
            "理由": "结构完整，顺序清晰",
            "证据": null
          },
          {
            "维度": "语言与规范",
            "等级": "A",
            "得分": 10,
            "总分": 10,
            "权重占比": 0.09,
            "理由": "语句通顺，表达清楚",
            "证据": "有同学问他时他却迟迟不回答，最后羞愧地回到了座位上"
          }
        ],
        "发展等级评分": [
          {
            "维度": "情节生动性",
            "等级": "C",
            "得分": 6,
            "总分": 10,
            "权重占比": 0.17,
            "理由": "情节平淡，像流水账",
            "证据": "于是军军和婷婷一起讨论该怎么办，最后同学们准备好了给李晓明过生日的场地"
          },
          {
            "维度": "细节具体性",
            "等级": "C",
            "得分": 6,
            "总分": 10,
            "权重占比": 0.11,
            "理由": "细节匮乏，多为概括叙述",
            "证据": "第二天李晓明一到教室，同学们拿着蛋糕迎接他"
          },
          {
            "维度": "情感真实性",
            "等级": "B",
            "得分": 8,
            "总分": 10,
            "权重占比": 0.06,
            "理由": "有情感表达，但稍显生硬",
            "证据": "他孤零零地站在最外围"
          },
          {
            "维度": "篇章技巧性",
            "等级": "B",
            "得分": 8,
            "总分": 10,
            "权重占比": 0.06,
            "理由": "结构完整，但设计常规",
            "证据": null
          }
        ],
        "通用评分": [
          {
            "维度": "字数",
            "等级": "C",
            "得分": 3,
            "总分": 5,
            "理由": "字数184字，达到要求字数的61%",
            "证据": "实际字数：184字"
          }
        ]
      },
      "comment": "这篇作文中心明确，紧扣为李晓明过生日的主题...",
      "outline": "...",
      "highlights": "...",
      "suggestions": "...",
      "paragraphs": ["...", "..."],
      "requirements": "...",
      "questions": ["...", "..."],
      "title": "李晓明过生日",
      "first_p": "...",
      "first_p_reason": "...",
      "last_p": "...",
      "last_p_reason": "...",
      "modify": "..."
    },
    "runse": { "...": "省略，结构参见《发送作文批改结果》" },
    "note": null
  }
}

提示：

  • 若仅关注评分结果，取 data.pigai.score（总分）和 data.pigai.score_detail（详情）即可。
  • 若需要展示维度雷达图，遍历 score_detail.基础等级评分 和 score_detail.发展等级评分 数组，取每个元素的 维度、得分、总分 绘制。
  • 若需要判断是否偏题，检查 score_detail.任务符合度 字段。