小练笔批改

一句话说明

提交一段「小练笔 / 微写作」做异步批改，针对训练目标给出短、准、可执行的反馈。
支持纯文本或图片作答；完成后回调推送结果。

发版说明：开放平台发版说明
回调字段形态接近大作文，见发送作文批改结果

你会得到什么

时机	得到什么
创建成功	`data.id`：小练笔任务 ID
批改完成	`pigai` / `pangpi` / `runse` 等（随选项变化）

适合 1~3 个训练目标的短文练习；长文请用创建作文批改。

计费

扣费方式	扣减
次数余额（`balance` / `pro_balance`）	0.5 次
金额余额（`amount`，单位分）	10 分（0.1 元）

is_pro 只影响从普通次数还是 Pro 次数扣，不改变 0.1 元单价。
余额不足时创建失败（常见 code=10001）。

怎么提交

方法：POST
地址：https://api.21days.cloud/opi/p/c012/micro_writing
Header：accessToken

两种作答方式（二选一）

方式	传什么	说明
纯文本	`content`	10~3000 字
图片	`images`	最多 10 张；每项含 `url` / `width` / `height`

title 与 topic_content 不能同时为空。

请求字段

字段	类型	默认	必填	说明
subject	String	`语文`	否	`语文` 或 `英语`
grade	String	`四年级`	否	年级
title	String	`''`	条件	题目
topic_content	String	`''`	条件	题干 / 情境要求
content	String	—	条件	文本作答
images	Array	—	条件	图片作答
total_score	Number	`100`	否	满分
words_count	Number	`300`	否	字数要求
writing_type	String	`小练笔`	否	建议保持「小练笔」或具体片段类型
correct_standard	String	`''`	否	训练目标 / 评分标准
score_items	Array	见下	否	要评哪些维度
item	Array	—	否	批改选项（评分、评语等）
is_pro	Number	`0`	否	是否走 Pro 次数账户
callback_url / is_dev	—	—	否	回调地址控制
version	Number	`1`	否	与学科组合生成 `version_name`
strictness	String	—	否	仅部分学科+版本生效
transmission	Object	—	否	透传

默认评分维度（不传 score_items 时）

切题 20、目标达成 30、内容具体 20、语言表达 20、结构清楚 10（合计 100）。

入参也可只传名称数组：["切题","目标达成","内容具体","语言表达","结构清楚"]。

创建成功响应

{
  "code": 1,
  "msg": "提交成功",
  "data": { "id": "mwAbc12" }
}

完成后用该 ID 对应回调，或走查询小练笔详情。

请求示例

文本模式

{
  "subject": "语文",
  "grade": "四年级",
  "title": "人物外貌描写",
  "topic_content": "用 100 字左右写出同学的外貌特点。",
  "correct_standard": "抓住 2~3 处外貌特征，有比喻更好。",
  "content": "同桌小明有一双亮晶晶的大眼睛……",
  "score_items": ["切题", "目标达成", "内容具体", "语言表达", "结构清楚"],
  "callback_url": "https://partner.example.com/callback"
}

图片模式

在上例基础上去掉 content，改为传 images。

对接检查清单

文本 / 图片是否只选一种有效作答
题目信息是否齐全；文本是否在 10~3000 字
回调是否可回 HTTP 200
是否按 0.1 元 / 0.5 次预留余额
过长作文是否应改走大作文接口

关联文档

主题	文档
查询详情	查询小练笔详情
回调结构	发送作文批改结果
大作文	创建作文批改