开放平台发版说明(2026-05-28)

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

变更类型说明

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

一、跨版本变更(全部批改接口)

变更 类型 旧行为 / 旧文档 新行为 / 新文档
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 已补齐字段说明,线上接口原本支持
高级评分书写规范 🔵 文档修正 08/09 文档未说明 partner 会写入 score_detail.通用评分[].书写规范 已补充语文 V2 / 英语 V4 的书写规范字段与扣分口径
partner 内部目录拆分 对外无感,不在合作方文档中展开

二、按 version_name 区分

version_name 类型 变更摘要
cn_v1 🟢 可选用 continuation_text素材推送1002;批改/旁批/润色契约不变
cn_v2 🟢 / 🟡 同上;strictness 三档已上线,本次补全文档交叉引用
cn_v3 🟢 / 🟡 语文作文批改 V3 入导航;多模态 OCR 兜底(ocr_text.vision_only);三档润色契约;strictness 三档(提示词口径,仅评分时生效)
cn_v3 🔵 旧版 03 文档写「默认=轻润色 / versions 含 3 篇」有误;正确:默认=中度润色versions 仅 2 篇
cn_v3 🔵 润色字数:仅提示词要求 ≥90% words_count偏短二次自动扩写(扩写兜底仅范文接口)
en_v2 / en_v3 🟢 同步 1002、continuation_text(若传);批改结构不变
en_v4 🟢 同上 + strictness(文档已有)
fanwen_v1 🟢 生成范文接口文档入导航(生成范文
banji_report_v1 🟢 新接口 班级作文报告(班级作文报告

本次无行为变更的接口

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


三、升级指南

提示词注入(1002)

平台先用正则初筛,命中后再交由 AI 复核,确认确实存在操纵 AI 的越权指令时才拦截code=0,顶层可能带 detail 命中明细与 ai_review 复核结论)。

若你确认某篇作文系误判(例如学生只是在记叙文里写”故意无视规则”),人工审核后可携带 skip_injection_check=1 重新提交,即可跳过该检测正常批改。


四、关联文档索引

主题 文档
创建入参 创建作文批改
回调结构 发送作文批改结果
查询详情 查询作文详情
接口总览 接口总览索引
语文 V3 语文作文批改 V3
语文 V2 语文作文批改 V2
英语 V4 英语作文批改 V4
生成范文 生成范文
班级报告 班级作文报告
查询账户 查询账户
错误码总览 开放平台说明