语文作文批改 V2(推荐)

一句话说明

语文作文高级评分版(新对接推荐):共用创建接口,传 subject=语文version=2
旁批、错别字、润色等与标准流程一致;评分改为等级制(A/B/C/D)加权总分,并支持偏题限分与评分松紧档。
版本怎么选见 语文版本怎么选

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


你会得到什么

你要的 在哪里 说明
版本标识 version_name 固定 cn_v2
总分 pigai.score 已按 total_score 折算
评分详情 pigai.score_detail 维度等级、偏题信息等
批改 / 旁批 / 润色 与 V1 同类字段 仍由 item 控制非评分能力

本版没有:自定义 score_items 结果(入参无效);不会返回 V1 那种 pigai.score_items


如何启用

字段 取值
subject 语文(本版仅语文)
version 2
writing_type 尽量传细分文体(见下)
topic_content 建议填写,便于偏题判断
strictness 可选:lenient / normal / strict

item 中即使传「评分」也会被忽略;评分由本版评分流程独立产出。


与其他语文版本比

完整对照见 语文版本怎么选。相对 V1:本版用等级制 + score_detail,支持偏题限分与 strictness;计费约 0.3 元 / 1.5 次


计费

扣费方式 扣减
次数余额 1.5 次
金额余额 30 分(0.3 元)

文体(writing_type)

请传题目要求的文体,尽量细分。例如能判断为「写人为主的记叙文」就不要只填「记叙文」。
仅在文体不限或多种文体均可时,才填 不限

常见可选值:不限、记叙文、写景为主的记叙文、写人为主的记叙文、叙事为主的记叙文、状物为主的记叙文、抒情为主的记叙文、说明文、想象作文、推荐文、议论文、应用文、剧本、日记、散文、诗歌、书信、倡议书、读后感。


评分松紧(strictness)

档位 含义
lenient 宽松:中等档次给分更高,偏题封顶也更高
normal 标准(默认)
strict 严苛:中等档次给分更低,偏题封顶更低

优等作文(各维多为 A)受档位影响较小。参考:各维同为 B 时,严苛 / 标准 / 宽松大约对应 70 / 80 / 90 分量级(满分 100 时)。


score_detail 怎么读

pigai.score_detail 为对象,常见包含:

内容 说明
总分 / 满分相关 pigai.score、创建时 total_score 对应
各评分维度 等级(A/B/C/D)、理由、证据等
偏题 / 任务符合度 用于理解限分原因
通用评分 可能含「书写规范」等项

对接时以 pigai.score 作为展示总分;需要明细时再解析 score_detail。具体键名以实际回调为准,建议做兼容解析。

其余 pigai 字段(评语、改写、亮点等)与 V1 相同语义,见回调总览。


请求示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"subject": "语文",
"version": 2,
"grade": "五年级",
"writing_type": "叙事为主的记叙文",
"title": "那一次,我真高兴",
"topic_content": "写一件让你高兴的事,注意把经过写清楚。",
"strictness": "normal",
"item": ["评语", "亮点", "不足和建议"],
"images": [
{ "url": "https://example.com/essay1.jpg", "width": 864, "height": 1920 }
],
"callback_url": "https://partner.example.com/callback"
}

对接检查清单

  1. version 是否为 2,学科是否为语文
  2. writing_type 是否尽量细分;topic_content 是否已填
  3. 是否按 score + score_detail 解析,而不是找 score_items
  4. 是否按需设置 strictness
  5. 计费是否按 1.5 次 / 0.3 元预留余额

关联文档

主题 文档
版本对照 语文版本怎么选
创建接口 创建作文批改
回调 发送作文批改结果
标准版 语文 V1
三档润色 语文 V3