开放平台发版说明(2026-05-28)
开放平台发版说明(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 |
| 生成范文 | 生成范文 |
| 班级报告 | 班级作文报告 |
| 查询账户 | 查询账户 |
| 错误码总览 | 开放平台说明 |
