简介

题小小作文开放平台面向教育厂商、机构与 SaaS 产品，提供作文批改、润色、旁批、范文生成等能力的 HTTP API。合作方在自有产品中完成上传与展示，平台负责 OCR、AI 批改与结果回调，无需自建大模型与教研 Prompt 体系。

接入前请阅读 开放平台说明，接口清单见 接口总览索引。

核心亮点

能力完整，一次对接覆盖主场景

  • 中英文作文批改：语文 V1/V2/V3、英语 V1/V2/V3/V4 多版本并存，按 version_name 选型，新对接英语建议优先 V4
  • 手写 OCR：支持图片上传，自动识别手写稿并进入批改流水线
  • 结构化输出：评分、总评、逐句批改、旁批坐标、润色稿等字段统一 JSON 回调，便于直接渲染
  • 专项能力：小练笔微写作、班级作文报告（beta）、生成范文（beta）、教材单元作文、看图生成题干等独立接口

教研沉淀，效果可对标一线产品

  • 10 余种经教研长期调教的批改模板，覆盖评分、评语、亮点、建议、思路点拨等维度
  • 语文高级评分（V2）：独立评分系统，维度 A/B/C/D 等级 + 偏题限分，支持 strictness 三档
  • 语文三档润色（V3，beta）：一次调用返回轻润色 / 中度润色 / 大改写，默认展示中度润色稿
  • 英语 V4：对接 score_en_1 高级评分与书写规范等细粒度反馈
  • 可选 素材推送（语文）：按本篇弱点推送典例、名著、金句，回调字段 materials_push 带出

对接简单，适合服务端集成

  • 异步任务 + HTTP 回调：提交即返回任务 ID，批改完成后推送至 callback_url，支持开发/生产环境分流（is_dev）
  • 查询补拉：查询作文详情 用于对账、重试与排查，与回调结构对齐
  • **透传字段 transmission**：合作方自定义元数据原样回传，方便绑定业务侧学生/作业 ID
  • **可配置批改项 item**：按需开关评分、旁批、润色、素材推送等，控制成本与展示
  • 统一鉴权（accessToken）、统一返回体（code / msg / data / detail），业务错误码（如 1000/1001/1002）文档化

稳定可控，面向生产环境设计

  • 批改前 错别字占比、OCR 失败、提示词注入（1002） 等业务拦截，减少无效调用与误判成本
  • 可选 未作答检测（continuation_text）：续写/参考原文场景下识别「几乎未作答」，0 分回调且不计入完整批改
  • 发版与契约变更集中在 开放平台发版说明，便于合作方评估升级影响
  • 支持定制评分标准（correct_standard）、总分、字数要求、Pro 版等，适配不同学段与产品形态

能力一览

类别 代表接口 说明
通用流程 创建 / 回调 / 查询 大作文批改主链路，各 version_name 共用创建入口
语文 V1 标准版、V2 高级评分、V3 三档润色 默认 V1，按需升级 V2/V3
英语 V1 标准版、V2 / V3 / V4（推荐） 默认 V1，新对接首选 V4
专项 小练笔、班级报告 短文本微写作、班级维度分析报告
辅助 单元作文、看图题干、生成范文 教材同步、看图写作、多立意范文批量生成

完整列表与状态（stable / beta）见 接口总览索引。

快速开始

  1. 联系客服开通接口权限并获取 accessToken（见 开放平台说明）
  2. 可选：调用 查询账户 确认余额与次数
  3. 服务端调用 创建作文批改，配置回调地址
  4. 按学科阅读对应版本文档（如 语文 V1、英语 V4）
  5. 实现 发送作文批改结果 回调解析，必要时用查询接口补拉

如需了解 C 端产品体验，可访问 题小小网页版 或微信小程序「题小小作文批改」；本站点仅描述开放 API，以接口文档为准。