发版说明（上线前查阅）

新对接请先完成「快速开始 → 开放平台说明 → 批改主流程 → 选版本」。本页是契约变更记录，适合联调完成、上线前对照。

本次发版同步开放接口近期对外契约变更，涵盖新接口、新字段、新错误码及文档修正。合作方可按 version_name 评估是否需要改造。

文档说明（2026-08-07）：全站接口文档已按统一结构重写（一句话说明 → 你会得到什么 → 调用方式 → 计费 → 示例 → 检查清单）。对外契约以各接口正文与本页变更为准；若旧页面表述与现文档冲突，以现文档为准。

变更类型说明

类型	标记	含义	合作方动作
破坏性变更	🔴	已有对接逻辑可能需改代码	必须评估升级
新增能力	🟢	新字段 / 新接口 / 新错误码，默认不影响旧逻辑	按需接入
行为优化	🟡	同字段下体验或稳定性改进，契约不变	建议知晓
文档修正	🔵	此前文档与线上一致性说明有误，接口行为以代码为准	核对旧实现

变更	类型	旧行为 / 旧文档	新行为 / 新文档
`continuation_text` 入参	🟢 新增	无	可选；传入后启用未作答检测，命中则 `code=1` + 0 分
`error_code=1002` 提示词注入	🟢 新增	仅 1000/1001	命中注入规则时 `code=0`，不再批改
`materials_push` 回调字段	🟢 新增	无此字段	默认 `null`；仅 `item` 含 `素材推送` 且语文时可能返回
创建接口字段补全	🔵 文档修正	02 文档未完整列出 `callback_url` / `is_dev` / `is_pro` / `topic_content_images`	已补齐字段说明，线上接口原本支持
高级评分书写规范	🔵 文档修正	旧文档未说明会写入 `score_detail.通用评分` 中的「书写规范」	已补充语文 V2 / 英语 V4 的书写规范字段与扣分口径

version_name	类型	变更摘要
cn_v1	🟢	可选用 `continuation_text`、`素材推送`、`1002`；批改/旁批/润色契约不变
cn_v2	🟢 / 🟡	同上；`strictness` 三档已上线，本次补全文档交叉引用
cn_v3	🟢 / 🟡	语文作文批改 V3 入导航；特殊识别场景可能带 `ocr_text.vision_only`；三档润色契约；`strictness` 三档（仅评分时生效）
cn_v3	🔵	旧文档写「默认=轻润色 / versions 含 3 篇」有误；正确：默认=中度润色，`versions` 仅 2 篇
cn_v3	🔵	润色字数以题目要求为参考；不保证偏短时自动二次扩写
en_v2 / en_v3	🟢	同步 1002、`continuation_text`（若传）；批改结构不变
en_v4	🟢 / 🟡	同上 + `strictness`；计费调整为标准版价位 0.2 元 / 1 次（不再按高级评分 0.3 元 / 1.5 次）
fanwen_v1	🟢	生成范文接口文档入导航（生成范文）
banji_report_v1	🟢	新接口班级作文报告（班级作文报告）
micro_writing	🟡	计费明确为 0.1 元 / 0.5 次（小练笔批改）
cn_v5 / en_v5	🟢	客户特殊定制，随时修改，请勿调用；支持图片或纯文本，简易总分+维度分+中文短评，0.06 元/次（特别版简易评分（V5））
cn_v6 / en_v6	🟢	客户特殊定制，随时修改，请勿调用；支持图片或纯文本；无旁批/错别字，保留批改/润色/评分；语文 0.1 / 英语 0.12 元，不支持 pro（定制版批改（V6））

以下接口文档未改契约，仅在本页标注无变更：英语 V2 / 英语 V3 专篇、单元作文详情、查询小练笔详情等历史页面。

平台会检测作文中是否夹带试图操纵批改结果的越权指令。确认存在此类内容时才会拦截（回调顶层 code=0，error_code=1002）。

若业务侧人工确认属于误判，可携带 skip_injection_check=1 重新提交以跳过该检测。