语文作文批改 V1
一句话说明
语文作文标准版：用共用创建接口，传 subject=语文、version=1（可不传，默认即为 1），完成评分、旁批、错别字校对、单篇润色等综合批改。
**新对接请优先使用 语文 V2**；版本怎么选见 语文版本怎么选。
创建入口：创建作文批改
回调总览：发送作文批改结果
发版说明：开放平台发版说明
你会得到什么
| 你要的 |
在哪里 |
说明 |
| 版本标识 |
version_name |
固定 cn_v1 |
| 总分 / 分项 |
pigai.score / pigai.score_items |
需创建时 item 含「评分」 |
| 总评、亮点、建议等 |
pigai.* |
随 item 勾选出现 |
| 旁批 |
pangpi |
句子点评 + 原图坐标 |
| 错别字 |
wrong_words |
逐字纠错 |
| 润色 |
runse |
单篇：title / content / explain |
| 素材推送 |
materials_push |
仅 item 含「素材推送」时可能有 |
本版没有：score_detail（V2）、runse.versions（V3）。
如何启用
| 字段 |
取值 |
| subject |
语文 |
| version |
1（或不传） |
| images |
必填（标准图片提交） |
成功后回调 / 详情中 version_name = cn_v1。
与其他语文版本比
完整对照见 语文版本怎么选。新对接推荐 V2；要三档润色看 V3（beta）。
计费
| 扣费方式 |
扣减 |
| 次数余额 |
1 次（Pro 走 Pro 次数） |
| 金额余额 |
20 分（0.2 元）（Pro 按约定） |
本版对接时重点字段
通用字段见创建文档。本版特别关心：
| 字段 |
说明 |
| item |
勾选需要的能力；可选 素材推送 |
| score_items |
自定义维度名；需 item 含「评分」 |
| continuation_text |
续写题未作答检测（可选） |
pigai 常见字段（随 item 出现）
| 字段 |
触发（item） |
说明 |
| score / score_items |
评分 |
总分与分项 |
| comment |
评语 |
含「精简批改」时更短 |
| highlights / suggestions |
亮点 / 不足和建议 |
亮点与改进建议 |
| title / first_p / last_p |
改写标题 / 改写开头结尾 |
改写稿及原因字段 |
| modify / paragraphs / questions 等 |
对应选项 |
改错、段评、提问等 |
请求示例
1
2
3
4
5
6
7
8
9
10
11
12
13
| {
"subject": "语文",
"version": 1,
"grade": "四年级",
"title": "难忘的一天",
"topic_content": "写一件让你难忘的事",
"item": ["评分", "评语", "亮点", "不足和建议"],
"score_items": ["内容", "结构", "语言"],
"images": [
{ "url": "https://example.com/essay1.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
| {
"code": 1,
"msg": "批改成功",
"data": {
"zuowen_id": "u3EDmPW",
"version_name": "cn_v1",
"status": 1,
"pigai": {
"score": 82,
"score_items": [
{ "item": "内容", "score": 85, "reason": "事情完整，细节可再丰富" }
],
"comment": "能把事情写清楚，中间可再补具体动作或对话。"
},
"pangpi": { "commit_items": [], "commit_total": "" },
"runse": { "title": "难忘的一天", "content": "…", "explain": "…" },
"materials_push": null
}
}
|
旁批 / 错别字 / OCR 结构见回调总览文档。
对接检查清单
subject=语文，version 为 1 或不传- 已传可访问图片；
title / topic_content 至少一个有值
item / score_items 是否覆盖产品要展示的模块- 需要素材推送时是否显式传了
素材推送
- 回调按
cn_v1 解析，不依赖 score_detail / runse.versions
关联文档
