定制版批改(V6)

指定客户专用能力,不作为通用对接方案。

接口行为、返回字段与计费可能随业务调整。未开通本能力的合作方请勿调用;新业务请优先对接标准批改版本。

一句话说明

用同一个创建接口,传 version=6,对学生作文做批改 + 润色 + 评分。
支持图片或纯文本;不产出旁批与错别字校对

学科 结果里的版本名 能力接近
语文 cn_v6 语文 V3(含三档润色)
英语 en_v6 英语 V4(评分与建议结构)

你会得到什么

你要的 在哪里 说明
批改 / 评分 pigai 语文接近 V3;英语接近 V4
润色 runse 语文含三档;英语为单篇
作文正文 content 文本提交为原文;图片提交为识别正文

本版不会返回:旁批、错别字校对。对应一般为 pangpi=[]wrong_words 为空。

英语「书写规范」按满分处理,不做卷面涂改扣分;字数扣分与内容评分仍正常。


怎么提交作文

创建接口与大作文相同:POST /p/c012/create_zuowen,**version 固定传 6**。

两种提交方式(二选一)

方式 传什么 说明
图片 images 须含 urlwidthheight;公网可访问
纯文本 content 去首尾空白后 10~8000

都传时:优先按图片
titletopic_content 不能同时为空;grade 必填。
本版不校验语文 V2/V3 文体白名单。
不支持 is_pro=1(创建会直接失败)。


计费

学科 次数余额 金额余额(分)
语文 0.5 次 10(0.1 元)
英语 0.6 次 12(0.12 元)

固定单价,不区分 Pro。


请求字段(本版关心)

字段 类型 默认 必填 说明
subject String 语文 语文英语
version Number 固定传 6
grade String 四年级 年级
title / topic_content String '' 条件 不能同时为空
images / content 条件 二选一
total_score Number 100 满分
words_count Number 400 字数 / 词数要求
score_items Array 评分维度(语文)
strictness String lenient / normal / strict
is_pro Number 0 必须为 0
callback_url / is_dev / transmission 与大作文一致

旁批类 item 对本版无产出意义。语文若需素材推送,仍可在 item 中传 素材推送


创建成功响应

字段 说明
code 1 表示提交成功
data.id 作文 ID

常见失败:未提供图片也未提供文本、is_pro=1、余额不足等。


评分完成后的回调

通用信封见 发送作文批改结果

字段 说明
version_name cn_v6 / en_v6
status 1 表示完成
pigai / runse 批改与润色
pangpi 固定 []
wrong_words 通常为空

图片识别失败 / 字过少:回调 code=0error_code=1001
本版一般不必error_code=1000 处理。


请求示例

语文 · 图片

1
2
3
4
5
6
7
8
9
10
11
{
"subject": "语文",
"version": 6,
"grade": "四年级",
"title": "难忘的一天",
"topic_content": "写一件让你难忘的事",
"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
{
"subject": "英语",
"version": 6,
"grade": "八年级",
"title": "My Best Friend",
"topic_content": "Write an essay about your best friend.",
"words_count": 120,
"content": "My best friend is Tom. He is tall and kind...",
"callback_url": "https://partner.example.com/callback"
}

对接检查清单

  1. 已确认开通本定制能力;非指定客户不要调用
  2. version=6,且未传 is_pro=1
  3. 图片与文本二选一;题目信息齐全
  4. 不要依赖旁批、错别字
  5. 英语不要按完整 V4 书写规范扣分逻辑展示

关联文档

主题 文档
创建接口 创建作文批改
回调 发送作文批改结果
语文基线 语文 V3
英语基线 英语 V4
简易评分定制 特别版 V5