题小小作文批改-文档

英语作文批改 V1英语作文标准版批改方案。创建、入参、响应与异步流程均与 创建作文批改 共用同一接口，无需单独 URL。 发版与变更记录见 开放平台发版说明。回调字段详见 发送作文批改结果，补拉见 查询作文详情。 如何启用本版本在 创建作文批改 请求 Body 中设置： 字段 取值 说明 subject '英语' 必填 version 1 不传时默认为 1 is_pro 0 / 1 按普通版或 Pro 版计费链路，见商务约定 成功后回调与详情查询中 data.version_name 为 **en_v1**。 版本特点 对比项 V1（本版本） V2 V3 V4 侧重点 综合批改 + 单篇润色 更侧重改错（mod_items） 综合批改（结构同通用回调） 高级评分 + 书写规范等 润色 单篇 runse 单篇 runse 单篇 runse 单篇 runse strictness 不生效 不生效 不生效 生效 新对接推荐 历史默认 历史对接 历史对接 首选 请求与响应完整入参、注意事项、错误码一律以 创建作文批 ...

语文作文批改 V1语文作文标准版批改方案。创建、入参、响应与异步流程均与 创建作文批改 共用同一接口，无需单独 URL。 发版与变更记录见 开放平台发版说明。回调字段详见 发送作文批改结果，补拉见 查询作文详情。 如何启用本版本在 创建作文批改 请求 Body 中设置： 字段 取值 说明 subject '语文' 必填 version 1 不传时默认为 1 is_pro 0 / 1 按普通版或 Pro 版计费链路，见商务约定 成功后回调与详情查询中 data.version_name 为 **cn_v1**。 版本特点 对比项 V1（本版本） V2 高级评分 V3 三档润色 评分方式 AI 直评 + 可自定义 score_items 独立高级评分，维度 A/B/C/D 与 V1 相同（AI 直评） 润色 单篇 runse 单篇 runse 默认中度 + runse.versions 2 篇（轻/大改写，共 3 档） strictness 不生效 生效 生效（提示词口径） ...

查询账户查询当前合作方账户的普通版剩余次数、Pro 版剩余次数与账户余额（分），用于对账、余额预警与上线前自检。 鉴权与通用返回规则见 开放平台说明。发版与变更记录见 开放平台发版说明。 注意事项 本接口为同步 GET，无请求 Body，调用后立即返回当前账户快照。 扣费发生在创建批改等写操作时；本接口仅查询，不扣费。 balance、pro_balance 为次数型余额（小数精度与后台配置一致）；amount 为金额余额，单位为分。 普通作文批改优先扣 balance（按版本单价，如 1 次 / 1.5 次）；Pro 批改扣 pro_balance；部分场景在次数不足时会扣 amount（详见商务约定）。 请求说明 HTTP 方法：GET 请求地址： 1https://api.21days.cloud/opi/p/c012/account URL 参数：无 Header：accessToken 鉴权（必填，见 开放平台说明） Body：无 响应说明 字段 类型 必选 示例 解释 code Number 是 1 1=成功，0=失败； ...

接口总览索引按业务域列出全部开放接口。变更记录以 开放平台发版说明 为准。 状态说明：stable 稳定可用；beta 测试中，未正式开放。 接入指南 文档 说明 状态 开放平台发版说明 发版与变更唯一来源 stable 开放平台说明 鉴权、返回规则、错误码 stable 查询账户 余额 / 次数 / 金额（分） stable 本文 接口索引 stable 作文批改通用流程 文档 version_name 状态 创建作文批改 各版本共用创建入口 stable 发送作文批改结果 回调结构总览 stable 查询作文详情 补拉与排查 stable 语文作文批改 文档 version_name 推荐 状态 语文作文批改 V1 cn_v1 标准版默认 stable 语文作文批改 V2 cn_v2 需高级评分时 stable 语文作文批改 V3 cn_v3 需三档润色时 beta 英语作文批改 文档 version_name 推荐 状态 英语作文批改 V1 en_v1 标准版默认 stable ...

班级作文报告测试中，未正式开放 发版与变更记录见 开放平台发版说明。 接口描述面向 B 端学校 / 教培机构的「班级作文报告」开放接口。合作方在已完成单篇作文批改（或已有人工评分）后，将题目要求与全班学生作文（含每篇得分与教师总评）一次性传入，由平台一次大模型调用产出整份精简学情报告，覆盖： 班级整体概况 量化指标（平均分、分数段分布、四级分层名单） 班级共性问题（含命中学生与原文证据） 班级共性亮点 针对性教学建议 典型范例（最佳 / 最需改进各 1 篇） 报告内容不包含 ECharts 图表配置、不输出练习题；合作方平台可直接基于 JSON 自行渲染。 鉴权方式与作文批改 / 范文生成一致：请求 Header 传 accessToken。 1. 创建任务请求说明 HTTP 方法：POST 请求地址： 1https://api.21days.cloud/opi/p/c012/banji_report Header：accessToken 鉴权 请求 Body 字段 类型 必填 说明 subject string 否 语文 ...

开放平台发版说明（2026-05-28）本次发版同步 partner 模块近期对外契约变更，涵盖新接口、新字段、新错误码及文档修正。合作方可按 version_name 评估是否需要改造。 变更类型说明 类型 标记 含义 合作方动作 破坏性变更 🔴 已有对接逻辑可能需改代码 必须评估升级 新增能力 🟢 新字段 / 新接口 / 新错误码，默认不影响旧逻辑 按需接入 行为优化 🟡 同字段下体验或稳定性改进，契约不变 建议知晓 文档修正 🔵 此前文档与线上一致性说明有误，接口行为以代码为准 核对旧实现 一、跨版本变更（全部批改接口） 变更 类型 旧行为 / 旧文档 新行为 / 新文档 continuation_text 入参 🟢 新增 无 可选；传入后启用未作答检测，命中则 code=1 + 0 分 error_code=1002 提示词注入 🟢 新增 仅 1000/1001 命中注入规则时 code=0，不再批改 materials_push 回调字段 🟢 新增 无此字段 默认 n ...

生成范文测试中，未正式开放 发版与变更记录见 开放平台发版说明。 接口描述 给定作文题目（标题 / 题干 / 字数要求 / 评分标准等），由 AI 先对题目做完整解析，再一次性生成 N 篇（默认 9 篇） 不同立意 / 角度的范文。 完全独立于作文批改接口，使用独立任务表、独立回调链路；不影响既有 V1 / V2 / V3 作文批改流程。 异步任务，立即返回任务 ID，完成后通过 callback_url 回调通知合作方。 按普通版价位 0.2 元/次 计费。 1. 创建范文任务请求说明 HTTP 方法：post 请求地址： 1https://api.21days.cloud/opi/p/c012/generate_fanwen URL 参数：无 Header：accessToken 鉴权 Body： 字段名称 类型 默认值 是否可选 说明 subject String ‘语文’ 否 学科，支持 语文 / 英语 grade String ‘四年级’ 否 年级 writi ...

语文作文批改 V3测试中，未正式开放 接口描述 提交一篇语文作文进行后台批改，与 V1 / V2 共用同一个 /p/c012/create_zuowen 接口。 V3 仅在润色阶段返回多版本：一次性输出 3 个不同改写幅度 的润色文章，便于合作方让老师/学生在 轻润色 / 中度润色 / 大改写 中自行选择。 落库时拆成默认 1 篇（中度润色）+ 额外 2 篇（轻润色 / 大改写）：默认字段 runse.title/content/explain 取最平衡的中档版，runse.versions 数组只放剩余 2 篇，前端展示 1 + 2 = 3 篇且无重复。 评分、批改、旁批等其它结构与 V1 标准版保持一致；不计入高级评分，仍按普通版价位 0.2 元/次计费。 与已有版本对比 对比项 标准版 V1 高级评分版 V2 多版本润色版 V3（本接口） 评分方式 AI 输出分数 独立高级评分系统 AI 输出分数（与 V1 一致） 评分粒度 单项 0-100 分 每维度 A/B/C&#x ...

查询小练笔详情通过创建接口返回的 ID 查询小练笔批改结果，用于事后对账、补拉数据或排查问题。 注意：数据只保存 1 周，且 30 秒更新一次，可能非实时数据，以回调通知数据为准。 HTTP 方法：get请求地址1https://api.21days.cloud/opi/p/c012/micro_writing/detail 请求参数 字段名 类型 描述 micro_writing_id string 创建小练笔批改时返回的 data.id 返回响应 字段 类型 必选 示例 解释 code Number 是 1 1=正常，0=异常，-1=未登录 msg String 否 - 提示信息 data object 否 见示例 与回调接口 data 基本一致，额外包含 micro_writing_id data 字段说明data 字段结构与回调接口《发送作文批改结果》中 data 完全一致，常用字段包括： 字段名 类型 描述 micro_writing_id string 当前小练笔任务 ID（创建接口返回的 i ...

小练笔批改接口描述 提交一段“小练笔/微写作”进行后台批改，针对 1~3 个训练目标输出短、准、可执行的反馈。 支持两种作答模式： 文本模式：直接传 content。 图片模式：传 images，平台先 OCR 识别再批改。 注意事项 AI 评分具有主观性，仅供参考。 文本模式下 content 长度需在 10~3000 字之间，过长建议改用大作文批改接口（《创建作文批改》）。 图片模式下每张图片需提供 url / width / height，单次最多 10 张，且图片需公开可访问；格式 jpg/jpeg/png/bmp，单图 ≤ 4M，最长边 ≤ 4096px。 title 与 topic_content 不能同时为空。 与大作文一致，平台会异步执行批改，完成后通过 callback_url 推送结果；详细字段定义见《发送作文批改结果》。 失败回调中可能携带与大作文相同的业务错误码（如 1000 错别字过多、1001 OCR 识别失败），详见《开放平台说明》。 请求说明 HTTP 方法：post 请求地址1https://api.21 ...