接口总览索引
按对接阅读顺序列出全部开放文档。变更记录以 开放平台发版说明 为准。
状态:stable 稳定可用;beta 测试中,未正式开放。
怎么读这份索引
- 必读:开始使用里的鉴权与账户
- 主流程:创建 → 回调 → 查询(所有版本共用)
- 选版本:先看语文 / 英语「版本怎么选」;新对接语文显式传 **
version=2**,英语显式传 **version=4**(勿依赖默认1) - 按需:更多能力
- 定制:V5 / V6,非指定客户不要接
一、开始使用(必读)
| 顺序 | 文档 | 说明 | 状态 |
|---|---|---|---|
| 1 | 快速开始 | 阅读路径总览 | stable |
| 2 | 开放平台说明 | 鉴权、返回规则、错误码 | stable |
| 3 | 查询账户 | 余额 / 次数 / 金额(分) | stable |
| 4 | 本文 | 接口索引 | stable |
| 后 | 发版说明 | 上线前看变更 | stable |
二、批改主流程(必读)
| 顺序 | 文档 | 说明 | 状态 |
|---|---|---|---|
| 1 | 创建作文批改 | 共用创建入口 | stable |
| 2 | 发送作文批改结果 | 回调结构 | stable |
| 3 | 查询作文详情 | 补拉与排查 | stable |
三、语文版本(选一)
| 文档 | version_name | 何时选 | 状态 |
|---|---|---|---|
| 语文版本怎么选 | — | 先看对照表 | stable |
| 语文 V2(推荐) | cn_v2 | 新对接首选(等级制 / 偏题限分) | stable |
| 语文 V1 | cn_v1 | 标准自定义维度;已接可继续 | stable |
| 语文 V3(三档润色) | cn_v3 | 要轻/中/大三档润色 | beta |
四、英语版本(选一)
| 文档 | version_name | 何时选 | 状态 |
|---|---|---|---|
| 英语版本怎么选 | — | 先看对照表 | stable |
| 英语 V4(推荐) | en_v4 | 新对接首选 | stable |
| 英语 V1(历史) | en_v1 | 已有对接可继续 | stable |
| 英语 V2(历史) | en_v2 | 已有对接可继续 | stable |
| 英语 V3(历史) | en_v3 | 已有对接可继续 | stable |
五、更多能力(按需)
| 文档 | 说明 | 状态 |
|---|---|---|
| 小练笔批改 | 短文本微写作 | stable |
| 查询小练笔详情 | 小练笔补拉 | stable |
| 班级作文报告 | 班级学情报告 | beta |
| 看图生成题干 | 看图写话题干 | stable |
| 单元作文详情 | 教材同步题目 | stable |
| 生成范文 | 多立意范文 | beta |
六、定制能力(请勿通用对接)
| 文档 | version_name | 说明 |
|---|---|---|
| 特别版简易评分(V5) | cn_v5 / en_v5 | 指定客户专用 |
| 定制版批改(V6) | cn_v6 / en_v6 | 指定客户专用 |
最短路径(复制即用)
新对接语文:快速开始 → 开放平台说明 → 创建 → 回调 → 语文版本怎么选 → 语文 V2
新对接英语:快速开始 → 开放平台说明 → 创建 → 回调 → 英语版本怎么选 → 英语 V4
