接口描述

获取中文作文批改分数和批改详情（推荐使用 v4 版本）

• 请求域名：v3.aes.ssapi.cn
• 支持协议：http、https
• 请求方式：POST 表单提交
• API：
  • /api/v3/cnEssayEvalute （v3版本后续不再维护）
  • /api/v4/cnEssayEvalute

测评请求参数

参数说明：

参数示例

测评参数示例如下：

app_id:a111
user_id:w9egtDf3PMAOaxZVGSlQUip12no6WCvu
warrant_id:5f9a80c56ef3aea0e54ff3431f019
"title": "一道菜"
"grade": 3
"essay_content": "它淡淡的绿色表皮上隆起许多卵形的小疙瘩，凹凸不平，像一条披着绿甲的鱼，还挑衅着吐着绿舌头。又像香蕉，像月牙，可没 有香蕉的甜味，不及月牙的美丽，连名字听起来都苦——苦瓜，但 这就是苦瓜。\n    看着苦瓜时我就想，竟然有这样一道祖先都不嫌它苦，把它从野生植物中选出来作为我们的。\n     看着这盘苦瓜，我感慨万千。我爱苦瓜绿色的生命，我最爱它 的本质——苦尽甘来。\"",
"essay_type": 3

测评返回结果

返回结果说明

结果示例

测评结果示例如下：

{
    "errId":0,
    "message":"success",
    "ret_time":"2023-10-10 14:29:12.266",
    "request":{
        "app_id":"a123",
        "warrant_id":"xxxxxxxxxxxxxxxxxxxxxx",
        "title":"一道菜",
        "grade":"3",
        "essay_content":"它淡淡的绿色表皮上隆起许多卵形的小疙瘩，凹凸不平，像一条披着绿甲的鱼，还挑衅着吐着绿舌头。又像香蕉，像月牙，可没 有香蕉的甜味，不及月牙的美丽，连名字听起来都苦——苦瓜，但 这就是苦瓜。\n    看着苦瓜时我就想，竟然有这样一道祖先都不嫌它苦，把它从野生植物中选出来作为我们的。\n     看着这盘苦瓜，我感慨万千。我爱苦瓜绿色的生命，我最爱它 的本质——苦尽甘来。\"",
        "essay_type":"3",
        "user_id":"123456"
    },
    "response":{
      "total_score": 81,
      "content_score": {
        "total": 82,
        "detail": [
          {
            "id": "切合题意",
            "value": 94
          },
          {
            "id": "中心明确",
            "value": 83
          },
          {
            "id": "内容充实",
            "value": 60
          },
          {
            "id": "情感表达",
            "value": 90
          }
        ]
      },
      "express_score": {
        "total": 81,
        "detail": [
          {
            "id": "语句通顺",
            "value": 72
          },
          {
            "id": "描写生动",
            "value": 90
          }
        ]
      },
      "structure_score": {
        "total": 78,
        "detail": [
          {
            "id": "段落分明",
            "value": 90
          },
          {
            "id": "条理清楚",
            "value": 67
          }
        ]
      },
      "development_score": {
        "total": 90,
        "detail": [
          {
            "id": "书写无误",
            "value": 90
          },
          {
            "id": "标点正确",
            "value": 90
          }
        ]
      },
      "detail": {
        "summary": {
          "gradeValue": "三年级",
          "predictedType": "记叙文-写事",
          "typeValue": "记叙文-写事",
          "totalWordNum": 169,
          "wordsNum": 114,
          "sentenceNum": 5,
          "paragraphNum": 3,
          "invalidParaNum": 1,
          "badWordNum": 0,
          "goodSentenceNum": 4,
          "goodQuoteNum": 2,
          "mismatchSentenceNum": 1,
          "evaluation": "",
          "advantage": "总评：文章直抒胸臆，打动人心，具有真情实感。\n\n内容：文章与题目联系密切，没有跑题。有些地方稍显重复哦，导致内容拖沓。情感细腻，有效渗透到了语言之中。\n表达：表达较为准确，基本没有语病。一些修辞用得不错，为文章增色不少。\n结构：段意表达完整，结构层层深入。个别地方条理不清，需重新设计。\n行文规范：文中无错别字，能正确使用常用的标点符号。\n",
          "disadvantage": "你可以尝试在文章开篇时，使用环境描写的方式，来为要叙述的事件进行铺垫。当然，环境氛围要和故事的中心、人物的特点形成相互照应。\n如：作文《白云、水滴》中写道：“蓝蓝的天上飘着一朵白云，白云里是一颗颗的小水滴，是谁让白云高高飘起？是那些小水滴，你挽着我，我挽着你，共同营造那一份自由和飘逸。\"文章以比喻开篇，拟人相衬，设问提起，语段极富诗意，为下文比喻我们的社会是一片白云，每个成员是白云中的一个分子做铺垫，启示我们应该共同营造美好的环境。",
          "rate": 0,
          "coreSentence": "",
          "chart": {
            "主题分": 89,
            "表达分": 81,
            "书法分": 90,
            "内容表达分": 75,
            "结构分": 78
          },
          "correctionTime": "2023-10-10 14:29",
          "expandPoetryVos": [
            {
              "id": 42007,
              "content": "别岸扁舟三两只。葭苇萧萧风淅淅。沙汀宿雁破烟飞，溪桥残月和霜白。渐渐分曙色。路遥山远多行役。往来人，只轮双桨，尽是利名客。\n一望乡关烟水隔。转觉归心生羽翼。愁云恨雨两牵萦，新春残腊相催逼。岁华都瞬息。浪萍风梗诚何益。归去来，玉楼深处，有个人相忆。",
              "title": "归朝欢·别岸扁舟三两只",
              "fanyi": "远处的岸边有小船三两只，淅淅的风吹着刚长出来的芦苇萧萧做响。江心沙洲宿雁冲破晓烟飞去。残月照在小桥上，小桥上的白霜显得更白，天渐渐的亮了。远远的路上行人渐渐的多起来。往来的人，无论是坐车的还是乘船的，都是为了名和利。\n一眼望去故乡关河相隔遥远。突然有一种归心似箭的感觉，恨不得生出双翅飞回家。愁云恨雨象丝缕一样牵萦着两地。日月相催，新春浦过残腊又到。年华转眼就过去。像浮萍和断梗一样随风水飘荡，有什么益处。还是回去吧。家中的玉楼里，有人在想我。",
              "contentList": [
                "别岸扁舟三两只。",
                "葭苇萧萧风淅淅。",
                "沙汀宿雁破烟飞，溪桥残月和霜白。",
                "渐渐分曙色。",
                "路遥山远多行役。",
                "往来人，只轮双桨，尽是利名客。",
                "一望乡关烟水隔。",
                "转觉归心生羽翼。",
                "愁云恨雨两牵萦，新春残腊相催逼。",
                "岁华都瞬息。",
                "浪萍风梗诚何益。",
                "归去来，玉楼深处，有个人相忆。"
              ],
              "zuozhe": "柳永",
              "chaodai": "宋代",
              "beijing": "创作背景\n\n　　柳永成年后离开家乡福建崇安县，虽寓居京都汴梁，但生活一直比较动荡。中举前为求取功名、维持生计，四处干谒漫游，中举后又为官务公事奔走在外，羁旅行役成了他的家常便饭。他对羁旅漂泊的苦况有着深切的体会乃至清醒的认识，为后人留下了许多羁旅行役词。[3] 这首《归朝欢》就是其中之一。此词写江南之景，可见作此词时，柳永正在江南；词中有“新春残腊相催逼”句，则说明此词作于冬春之交，新春之时；“玉楼深处，有个人相忆”二句说明此词乃柳永思妻之作。",
              "source": ""
            }
          ],
          "expandSentenceVos": [
            {
              "id": 42505,
              "sentence": "今天,邻居邀请我们一家去他奶奶家游玩.我们到了那儿,来慢了一步,他们已经把花生从土里邀请出来了,真遗憾!不过,还有一些欢乐的工作需要我们去去做,就是去菜园里拿菜.我们到了菜园,一片绿色的植物从土里探出头来,像一片绿色的海洋.我们摘了冬瓜丝瓜西红柿白菜土豆......",
              "studentName": null,
              "studentId": null,
              "sort": null
            }
          ],
          "expandQuoteVos": [
            {
              "id": null,
              "author": null,
              "content": null
            }
          ],
          "title": "一道菜"
        },
        "parse": {
          "paragraphs": [
            {
              "segments": [
                {
                  "id": 24248278,
                  "sectionId": 15365272,
                  "type": "SERIAL",
                  "value": "1",
                  "startIndex": 0,
                  "endIndex": 44,
                  "types": [
                    "SERIAL",
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248278,
                  "sectionId": 15365272,
                  "type": "GOOD_SENTENCE",
                  "value": "它淡淡的绿色表皮上隆起许多卵形的小疙瘩，凹凸不平，像一条披着绿甲的鱼，还挑衅着吐着绿舌头。",
                  "startIndex": 0,
                  "endIndex": 44,
                  "types": [
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248278,
                  "sectionId": 15365272,
                  "type": "ICON",
                  "value": "GOOD",
                  "startIndex": 0,
                  "endIndex": 44,
                  "types": [
                    "ICON",
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248279,
                  "sectionId": 15365273,
                  "type": "SERIAL",
                  "value": "2",
                  "startIndex": 45,
                  "endIndex": 90,
                  "types": [
                    "SERIAL",
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248279,
                  "sectionId": 15365273,
                  "type": "GOOD_SENTENCE",
                  "value": "又像香蕉，像月牙，可没有香蕉的甜味，不及月牙的美丽，连名字听起来都苦——苦瓜，但这就是苦瓜。",
                  "startIndex": 45,
                  "endIndex": 90,
                  "types": [
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248279,
                  "sectionId": 15365273,
                  "type": "ICON",
                  "value": "GOOD",
                  "startIndex": 45,
                  "endIndex": 90,
                  "types": [
                    "ICON",
                    "GOOD_SENTENCE"
                  ]
                }
              ],
              "sectionEvaluations": [
                {
                  "sectionId": 15365272,
                  "serialNo": 1,
                  "value": "对事物的大小和颜色进行描写"
                },
                {
                  "sectionId": 15365273,
                  "serialNo": 2,
                  "value": "使用了比喻，形象生动"
                }
              ],
              "evaluation": "",
              "paragraphId": 8284987,
              "paragraphContent": "它淡淡的绿色表皮上隆起许多卵形的小疙瘩，凹凸不平，像一条披着绿甲的鱼，还挑衅着吐着绿舌头。又像香蕉，像月牙，可没有香蕉的甜味，不及月牙的美丽，连名字听起来都苦——苦瓜，但这就是苦瓜。"
            },
            {
              "segments": [
                {
                  "id": 24248280,
                  "sectionId": 15365274,
                  "type": "BAD_SENTENCE",
                  "value": "看着苦瓜时我就想，竟然有这样一道祖先都不嫌它苦，把它从野生植物中选出来作为我们的。",
                  "startIndex": 0,
                  "endIndex": 40,
                  "types": null
                },
                {
                  "id": 24248280,
                  "sectionId": 0,
                  "type": "BAD_SENTENCE_EVALUATION",
                  "value": "(语句句意可能不完整。)",
                  "startIndex": 0,
                  "endIndex": 40,
                  "types": []
                }
              ],
              "sectionEvaluations": [],
              "evaluation": "",
              "paragraphId": 8284988,
              "paragraphContent": "看着苦瓜时我就想，竟然有这样一道祖先都不嫌它苦，把它从野生植物中选出来作为我们的。"
            },
            {
              "segments": [
                {
                  "id": 24248281,
                  "sectionId": 0,
                  "type": "DEFAULT",
                  "value": "看着这盘苦瓜，我",
                  "startIndex": 0,
                  "endIndex": 0,
                  "types": []
                },
                {
                  "id": 24248282,
                  "sectionId": 15365276,
                  "type": "GOOD_QUOTE",
                  "value": "感慨万千",
                  "startIndex": 8,
                  "endIndex": 11,
                  "types": null
                },
                {
                  "id": 24248283,
                  "sectionId": 0,
                  "type": "DEFAULT",
                  "value": "。",
                  "startIndex": 0,
                  "endIndex": 0,
                  "types": []
                },
                {
                  "id": 24248284,
                  "sectionId": 15365277,
                  "type": "SERIAL",
                  "value": "4",
                  "startIndex": 13,
                  "endIndex": 36,
                  "types": [
                    "SERIAL",
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248284,
                  "sectionId": 15365277,
                  "type": "GOOD_SENTENCE",
                  "value": "我爱苦瓜绿色的生命，我最爱它的本质——",
                  "startIndex": 13,
                  "endIndex": 36,
                  "types": [
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248285,
                  "sectionId": 15365278,
                  "type": "GOOD_QUOTE",
                  "value": "苦尽甘来",
                  "startIndex": 32,
                  "endIndex": 35,
                  "types": [
                    "GOOD_QUOTE",
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248286,
                  "sectionId": 15365277,
                  "type": "GOOD_SENTENCE",
                  "value": "。",
                  "startIndex": 13,
                  "endIndex": 36,
                  "types": [
                    "GOOD_SENTENCE"
                  ]
                },
                {
                  "id": 24248286,
                  "sectionId": 15365277,
                  "type": "ICON",
                  "value": "GOOD",
                  "startIndex": 13,
                  "endIndex": 36,
                  "types": [
                    "ICON",
                    "GOOD_SENTENCE"
                  ]
                }
              ],
              "sectionEvaluations": [
                {
                  "sectionId": 15365277,
                  "serialNo": 4,
                  "value": "这句话富有感情，写得很出色"
                }
              ],
              "evaluation": "",
              "paragraphId": 8284989,
              "paragraphContent": "看着这盘苦瓜，我感慨万千。我爱苦瓜绿色的生命，我最爱它的本质——苦尽甘来。"
            }
          ],
          "goodList": [
            {
              "sectionId": 15365272,
              "serialNo": 1,
              "type": "GOOD_SENTENCE",
              "content": "它淡淡的绿色表皮上隆起许多卵形的小疙瘩，凹凸不平，像一条披着绿甲的鱼，还挑衅着吐着绿舌头。",
              "explain": "",
              "extension": "",
              "example": "",
              "homoionym": "",
              "antonym": "",
              "evaluation": "对事物的大小和颜色进行描写",
              "bookmarkId": null
            },
            {
              "sectionId": 15365273,
              "serialNo": 2,
              "type": "GOOD_SENTENCE",
              "content": "又像香蕉，像月牙，可没有香蕉的甜味，不及月牙的美丽，连名字听起来都苦——苦瓜，但这就是苦瓜。",
              "explain": "",
              "extension": "",
              "example": "",
              "homoionym": "",
              "antonym": "",
              "evaluation": "使用了比喻，形象生动",
              "bookmarkId": null
            },
            {
              "sectionId": 15365275,
              "serialNo": 3,
              "type": "GOOD_SENTENCE",
              "content": "看着苦瓜时",
              "explain": "",
              "extension": "",
              "example": "",
              "homoionym": "",
              "antonym": "",
              "evaluation": "时间线索",
              "bookmarkId": null
            },
            {
              "sectionId": 15365276,
              "serialNo": null,
              "type": "GOOD_QUOTE",
              "content": "感慨万千",
              "explain": "因外界事物变化很大而引起许多感想、感触。",
              "extension": "路遥《平凡的世界》第二卷第30章：“孙玉厚坐在这里，心里忍不住感慨万千。”",
              "example": "王朔《许爷》：“他大概无法拒绝这样一种关系的人在这样一种凄惨的情况下相遇那种感慨万千的效果的诱惑。”",
              "homoionym": "无限感慨",
              "antonym": "",
              "evaluation": "好的引用词",
              "bookmarkId": null
            },
            {
              "sectionId": 15365277,
              "serialNo": 4,
              "type": "GOOD_SENTENCE",
              "content": "我爱苦瓜绿色的生命，我最爱它的本质——苦尽甘来。",
              "explain": "",
              "extension": "",
              "example": "",
              "homoionym": "",
              "antonym": "",
              "evaluation": "这句话富有感情，写得很出色",
              "bookmarkId": null
            },
            {
              "sectionId": 15365278,
              "serialNo": null,
              "type": "GOOD_QUOTE",
              "content": "苦尽甘来",
              "explain": "尽：终结；甘：甜；美好。比喻艰苦的日子已经过去；美好的时光已经到来。",
              "extension": "元 关汉卿《蝴蝶梦》第四折：“受彻了牢狱灾，今日个苦尽甘来。”",
              "example": "老两口过了半辈子苦日子，今天总算苦尽甘来了。",
              "homoionym": "否极泰来、时来运转、雨过天晴",
              "antonym": "乐极生悲",
              "evaluation": "好的引用词",
              "bookmarkId": null
            }
          ],
          "recommendSentencesByCore": [],
          "recommendSentencesByTitle": []
        }
      }
    }
}

错误码

错误码参考：作文批改错误码