2.创建作文批改
创建作文批改
接口描述
- 提交一篇作文进行后台批改
注意事项
- AI评分具有主观性,仅供参考;
- 图片质量差(如含大片深色内容)可能导致识别失败;
- 内容含敏感词(政治、色情、暴力等)将无法批改。
- 作文批改有一定的失败几率,比如图片url读取失败、文字未识别到、内容违规等等异常
请求说明
- HTTP 方法:post
- 请求地址
1
https://api.21days.cloud/opi/p/c012/create_zuowen
- URL参数:无
- Header:accessToken鉴权
- Body:
字段名称 | 类型 | 默认值 | 是否可选 | 说明 |
---|---|---|---|---|
subject | String | ‘语文’ | 否 | 作文所属学科,可选值:’语文’ 或 ‘英语’ |
total_score | Number | 100 | 否 | 作文总分(只能设为100,自行按比例换算用户设定分值,如用户设40分,60/100分换算为24/40分,对应优良中差、ABCD标准) |
words_count | Number | 400 | 否 | 作文字数要求 |
grade | String | ‘四年级’ | 否 | 适用年级(如’三年级’、’九年级’、’初二’) |
writing_type | String | ‘不限’ | 是 | 作文类型(写人/叙事/写景/状物记叙文、抒情文、议论文等;中小学建议普通版,初高中建议pro版) |
title | String | ‘题目自拟’ | 是 | 作文标题,若留空需通过题干明确主题 |
topic_content | String | ‘’ | 是 | 作文题干,描述写作要求、主题等核心指引 |
correct_standard | String | ‘’ | 是 | 评分标准(包含内容、结构、语言等维度,支持自定义) |
images | Array | [] | 是 | 作文原图URL列表(示例:[{"url":"...","width":864,"height":1920}] )要求:图片需剪裁避免地板、桌面等深色内容,仅支持百度云存储(公开可访问),格式为jpg/jpeg/png/bmp,单图≤4M,最长边≤4096px。 |
item | Array | [] | 是 | 批改结果类型(可包含评分、评语、批注等,支持以下维度: 评分、改写标题、改写开头结尾、修改错误、评语、段评、亮点、写作要求、写作思路、不足和建议、提问、精简批改) |
score_items | Array | [] | 是 | 评分细项(示例:内容、表达、结构、情感、主题),只有在item中包含“评分”的情况下才有效。为空时不返回评分明细 |
响应说明
字段 | 类型 | 必选 | 示例 | 解释 |
---|---|---|---|---|
code | Number | 是 | 0 | 1=正常,0=异常,-1=未登录 |
msg | String | 否 | - | 提示信息 |
data | object | 否 | {“id”: “u3EDmPW”} | 核心数据(作文ID) |
- 注意提交后马上返回作文ID,等待批改完成后,结果会通知到callback_url