创建作文批改

接口描述

  • 提交一篇作文进行后台批改

注意事项

  1. AI评分具有主观性,仅供参考;
  2. 图片质量差(如含大片深色内容)可能导致识别失败;
  3. 内容含敏感词(政治、色情、暴力等)将无法批改。
  4. 作文批改有一定的失败几率,比如图片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