先声智能开放平台-中英文口语评测,中英文作文批改

接口描述

获取英文作文批改分数和语法纠错详情（推荐使用 v4 版本）

请求域名：v3.aes.ssapi.cn
支持协议：http、https
请求方式：POST 表单提交

API：

/api/v4/essayEvalute

测评请求参数

参数说明：

字段	类型	可选	说明
app_id	string	必选	授权商户的 app_id
user_id	string	必选	商户自身的user_id，需要和获取warrant_id时使用的user_id保持一致
warrant_id	string	必选	鉴权参数，通过接口 /api/v3/authorize 获取
question_type	string	必选	作文内容题型 - 自定义题目:custom
essay_content	string	必选	作文内容
essay_id	string	必选	作文题id，参考英文作文相关说明

参数示例

测评参数示例如下：

app_id:a111
user_id:w9egtDf3PMAOaxZVGSlQUip12no6WCvu
warrant_id:5f9a80c56ef3aea0e54ff3431f019
question_type:custom
essay_content:Traveling by train has been one of the principal transport methods in China for decades.
essay_id:pri000000

测评返回结果

返回结果说明

键	类型	说明
errId	int	错误码
message	string	简要返回信息
ret_time	string	返回结果的时间
record_id	string	评测唯一记录id
request_id	string	请求流水id
uri	string	请求接口
request	object	请求参数
- appid	string	appid
- user_id	string	用户id，需要和获取warrant_id时使用的user_id保持一致
- warrant_id	string	鉴权参数，通过接口 /api/v3/authorize 获取
- question_type	string	作文内容题型 - 固定题目:fix 自定义题目:custom
- essay_content	string	作文内容
- essay_id	string	作文题id，参考英文作文相关说明
response	object	返回结果
- grammar_score	int	语法分，10分制
- lexicon_score	int	词汇分，10分制
- origin_score	int	原始总分，100分制
- readability_score	int	可读性得分，10分制
- topic_score	int	话题分，10分制
- total_score	int	总分，10分制
- comment	string	评语
- details	array
-- errors	array	错误信息
-- lexical_knowledge	array	词汇相关知识
-- origin	int	原始文本
-- correct	int	修改后的文本
-- sent_id	int	句子序号
-- para_id	int	段落序号
-- start_site	int	句子开始所在原始文本位置（从0开始）

结果示例

测评结果示例如下：

{
  "message": "success",
  "errId": 0,
  "response": {
    "grammar_score": 0,
    "lexicon_score": 0,
    "origin_score": 0,
    "readability_score": 0,
    "topic_score": 0,
    "total_score": 0,
    "comment": "文章以简单句为主，句式单调、乏味，且语法错误严重。建议加强基础语法知识的掌握，全面提高写作水平。",
    "details": [
      {
        "origin": "traveling by train has been one at the principal transports methods in China for decade.",
        "correct": "Traveling by train has been one of the principal transport methods in China for decades.",
        "sent_id": 0,
        "para_id": 0,
        "errors": [
          {
            "error_type": "first_letter_upper",
            "operation": "replace",
            "knowledge": {
              "name": "首字母大写",
              "cause": "一句话的第一个单词首字母需要大写",
              "desc": ""
            },
            "position": [
              0,
              9
            ],
            "src_word": "traveling",
            "tgt_word": "Traveling"
          },
          {
            "error_type": "preposition",
            "operation": "replace",
            "knowledge": {
              "name": "介词错误",
              "cause": "介词与形容词、名词、动词、动词词组的搭配要根据上下文语义",
              "desc": "英语介词表示名词、代词等与句中其它词的关系，在句中不能单独作句子成分。介词按词义可分为地点介词、方向介词、时间介词、方式介词、目的介词、比较介词、原因介词和伴随介词等。"
            },
            "position": [
              32,
              34
            ],
            "src_word": "at",
            "tgt_word": "of"
          },
          {
            "error_type": "word_form",
            "operation": "replace",
            "knowledge": {
              "name": "单词形式",
              "cause": "单词需要根据具体语境选择相应的单词形式",
              "desc": ""
            },
            "position": [
              49,
              59
            ],
            "src_word": "transports",
            "tgt_word": "transport"
          },
          {
            "error_type": "noun_singular_plural",
            "operation": "replace",
            "knowledge": {
              "name": "名词单复数",
              "cause": "英语中的单数量词一般与单数名词搭配，复数量词一般与复数名词搭配。",
              "desc": "英语中名词可分为可数名词和不可数名词。可数名词在应用时有单数和复数形式，表示一个用单数，表示两个或两个以上用复数。一般情况下，单数可数名词可通过加-s构成复数形式，但也有很多不规则的变化，如：class -> classes, city -> cities, tomato -> tomatoes, photo -> photos, belief -> beliefs, thief -> thieves 等。"
            },
            "position": [
              81,
              87
            ],
            "src_word": "decade",
            "tgt_word": "decades"
          }
        ],
        "start_site": 0
      }
    ]
  },
  "ret_time": "2022-12-09 16:57:53.056",
  "request": {
    "warrant_id": "620b6c113d79e151034468ec2d26a4b9f",
    "user_id": "12138bsg",
    "app_id": "a654",
    "essay_content": "traveling by train has been one at the principal transports methods in China for decade.",
    "question_type": "custom",
    "essay_id": "pri000000",
    "essay_type": "essay_license"
  },
  "record_id": "11ed90a4c400a6541d1e6"
}

API：

/api/v4/proEnEssayScore

测评请求参数

参数说明：

字段	类型	可选	说明
app_id	string	必选	授权商户的 app_id
user_id	string	必选	商户自身的user_id，需要和获取warrant_id时使用的user_id保持一致
warrant_id	string	必选	鉴权参数，通过接口 /api/v3/authorize 获取
essay_content	string	必选	作文内容
task_description	string	必选	作文题目英文描述，作为内容分评分与评语依据，如：You should write a house rental ad including rooms in the house and furniture in each room.
grade	int	必选	年级 1-12, <=6 是小学，对评语与分数有影响。
essay_id	string	必选	作文题id，参考英文作文相关说明

参数示例

测评参数示例如下：

warrant_id:6778d86bce557cb379ae490b1f019
user_id:1d88abc9244d10420f892682a9aa48a8ba23
app_id:axxx
essay_content:To bring out the best in yourself, you should improve your future by working on it today. You should set goals and stick to them. You should allow yourself to fail. You should see the good in everything. You should accept others and be yourself.
task_description:You should list what to do to improve yourself. Six ways are mentioned in the passage. You need to list 5 ways referring to the passage as much as possible.\nWays mentioned in the passage: Improve the future.  Accept others. Be yourself.\nAllow yourself to fail. See the good in everything. Set goals and stick to them.
essay_id:0000
grade:1

测评返回结果

返回结果说明

键	类型	说明
errId	int	错误码
message	string	简要返回信息
ret_time	string	返回结果的时间
record_id	string	评测唯一记录id
request_id	string	请求流水id
uri	string	请求接口
request	object	请求参数
- app_id	string	app_id
- user_id	string	用户id，需要和获取warrant_id时使用的user_id保持一致
- warrant_id	string	鉴权参数，通过接口 /api/v3/authorize 获取
- essay_content	string	作文内容
- task_description	string	作文题目英文描述
- grade	string	年级
- essay_id	string	作文题id，参考英文作文相关说明
response	object	返回结果
- grammar_score	int	语法分，10分制
- lexicon_score	int	词汇分，10分制
- origin_score	int	原始总分，100分制
- readability_score	int	可读性得分，10分制
- topic_score	int	话题分，10分制
- total_score	int	总分，10分制
- comment	string	评语
- details	array
-- errors	array	错误信息
-- lexical_knowledge	array	词汇相关知识
-- origin	int	原始文本
-- correct	int	修改后的文本
-- sent_id	int	句子序号
-- para_id	int	段落序号
-- start_site	int	句子开始所在原始文本位置（从0开始）

结果示例

测评结果示例如下：

{
  "request": {
    "app_id": "axxx",
    "user_id": "1d88abc9244d10420f892682a9aa48a8ba23",
    "warrant_id": "6778d86bce557cb379ae490b1f019",
    "grade": "1",
    "essay_content": "To bring out the best in yourself, you should improve your future by working on it today. You should set goals and stick to them. You should allow yourself to fail. You should see the good in everything. You should accept others and be yourself.",
    "task_description": "You should list what to do to improve yourself. Six ways are mentioned in the passage. You need to list 5 ways referring to the passage as much as possible.\\nWays mentioned in the passage: Improve the future.  Accept others. Be yourself.\\nAllow yourself to fail. See the good in everything. Set goals and stick to them.",
    "essay_id": "0000",
    "main_point": null
  },
  "response": {
    "grammar_score": 9,
    "lexicon_score": 9,
    "origin_score": 53,
    "readability_score": 7,
    "topic_score": 10,
    "total_score": 8,
    "comment": "内容:\n这篇作文涵盖了题目要求的五种提升自我的方式，并且准确地反映了原文中提到的内容。作者提到了“改善未来”、“设定目标并坚持”、“允许自己失败”、“看到一切中的美好”以及“接受他人和做自己”。虽然表达较为简略，但基本达到了题目的要求。\n\n词汇与语法:\n作文中的词汇选择简单明了，适合小学水平。语法结构基本正确，句子通顺易懂。个别地方可以更具体一些，但整体上没有明显的语法错误。\n\n篇章结构:\n文章结构清晰，每句话都对应一个提升自我的方法，条理分明。尽管没有复杂的段落划分或过渡句，但这种简洁的方式使得文章易于理解。每个要点都得到了提及，符合题目的要求。",
    "details": [
      {
        "origin": "To bring out the best in yourself, you should improve your future by working on it today.",
        "correct": "To bring out the best in yourself, you should improve your future by working on it today.",
        "errors": [],
        "start_site": 0,
        "sent_id": 0,
        "para_id": 0
      },
      {
        "origin": "You should set goals and stick to them.",
        "correct": "You should set goals and stick to them.",
        "errors": [],
        "start_site": 90,
        "sent_id": 1,
        "para_id": 0
      },
      {
        "origin": "You should allow yourself to fail.",
        "correct": "You should allow yourself to fail.",
        "errors": [],
        "start_site": 130,
        "sent_id": 2,
        "para_id": 0
      },
      {
        "origin": "You should see the good in everything.",
        "correct": "You should see the good in everything.",
        "errors": [],
        "start_site": 165,
        "sent_id": 3,
        "para_id": 0
      },
      {
        "origin": "You should accept others and be yourself.",
        "correct": "You should accept others and be yourself.",
        "errors": [],
        "start_site": 204,
        "sent_id": 4,
        "para_id": 0
      }
    ]
  },
  "message": "success",
  "errId": 0,
  "ret_time": "2025-01-16 15:59:23.242",
  "record_id": "11efc8265da4a65400"
}

API：

/api/v3/essayEvalute （v3版本后续不再维护）

测评请求参数

参数说明：

字段	类型	可选	说明
app_id	string	必选	授权商户的 app_id
user_id	string	必选	商户自身的user_id，需要和获取warrant_id时使用的user_id保持一致
warrant_id	string	必选	鉴权参数，通过接口 /api/v3/authorize 获取
question_type	string	必选	作文内容题型 - 固定题目:fix 自定义题目:custom
essay_content	string	必选	作文内容
essay_id	string	必选	作文题id，参考英文作文相关说明
main_point	string	可选	作文要点，每个单词用空格隔开; 只在自定义题目类型(question_type 为 custom)时有效

参数示例

测评参数示例如下：

app_id:a111
user_id:w9egtDf3PMAOaxZVGSlQUip12no6WCvu
warrant_id:5f9a80c56ef3aea0e54ff3431f019
question_type:fix
essay_content:Traveling by train has been one of the principal transport methods in China for decades.
essay_id:11

测评返回结果

返回结果说明

键	类型	说明
errId	int	错误码
message	string	简要返回信息
ret_time	string	返回结果的时间
record_id	string	评测唯一记录id
request_id	string	请求流水id
uri	string	请求接口
request	object	请求参数
- appid	string	appid
- user_id	string	用户id，需要和获取warrant_id时使用的user_id保持一致
- warrant_id	string	鉴权参数，通过接口 /api/v3/authorize 获取
- question_type	string	作文内容题型 - 固定题目:fix 自定义题目:custom
- essay_content	string	作文内容
- essay_id	string	作文题id，参考英文作文相关说明
response	object	返回结果
- grammar_score	int	语法分，10分制
- lexicon_score	int	词汇分，10分制
- origin_score	int	原始总分，100分制
- readability_score	int	可读性得分，10分制
- topic_score	int	话题分，10分制
- total_score	int	总分，10分制
- details	array
-- errors	array	已废弃
-- errors2	array	错误类型请参考英文作文批改相关说明
-- lexical_knowledge	array	词汇相关知识
-- origin	int	原始文本
-- correct	int	修改后的文本
-- sent_id	int	句子序号
-- para_id	int	段落序号

结果示例

测评结果示例如下：

{
  "message": "success",
  "errId": 0,
  "response": {
    "grammar_score": 6,
    "lexicon_score": 4,
    "origin_score": 75,
    "readability_score": 6,
    "topic_score": 3,
    "total_score": 4,
    "details": [
      {
        "correct": "All in all , he is a good friend . I like staying with him .",
        "lexical_knowledge": [
          [
            [
              "friend",
              [
                {
                  "phrases": "Over 9 levels deep, aborting normalization",
                  "query": "Over 9 levels deep, aborting normalization",
                  "wfs": "Over 9 levels deep, aborting normalization",
                  "explains": "Over 9 levels deep, aborting normalization",
                  "translation": "Over 9 levels deep, aborting normalization",
                  "samples": "Over 9 levels deep, aborting normalization",
                  "us-phonetic": "Over 9 levels deep, aborting normalization",
                  "antonym": "Over 9 levels deep, aborting normalization",
                  "uk-phonetic": "Over 9 levels deep, aborting normalization",
                  "synonyms": "Over 9 levels deep, aborting normalization",
                  "phonetic": "Over 9 levels deep, aborting normalization"
                }
              ]
            ]
          ],
          [
          ]
        ],
        "origin": "All in all , he is a good friend.I like staying with him .",
        "sent_id": 2,
        "para_id": 0,
        "errors": "[[\"typo\",8,\"friend.I\",\"friend\"],[\"insertion\",8,\". I\"]]",
        "errors2": [
          {
            "error_type": "typo",
            "tgt_word": "friend",
            "src_word": "friend.I",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 8
          },
          {
            "error_type": "insertion",
            "tgt_word": ". I",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 8
          }
        ]
      },
      {
        "correct": "However , in some ways , I am different from him . He studies harder than me . He is always one of the top students in the grade . But my PE grades are much better than him . In other ways , we have something in common . For example , both he and I like to laugh and enjoy milk .",
        "lexical_knowledge": [
          [
          ],
          [
          ],
          [
            [
              "him",
              [
                {
                  "phrases": "Over 9 levels deep, aborting normalization",
                  "query": "Over 9 levels deep, aborting normalization",
                  "explains": "Over 9 levels deep, aborting normalization",
                  "translation": "Over 9 levels deep, aborting normalization",
                  "samples": "Over 9 levels deep, aborting normalization",
                  "us-phonetic": "Over 9 levels deep, aborting normalization",
                  "antonym": "Over 9 levels deep, aborting normalization",
                  "uk-phonetic": "Over 9 levels deep, aborting normalization",
                  "synonyms": "Over 9 levels deep, aborting normalization",
                  "phonetic": "Over 9 levels deep, aborting normalization"
                }
              ]
            ]
          ],
          [
          ],
          [
            [
              "grade",
              [
                {
                  "phrases": "Over 9 levels deep, aborting normalization",
                  "query": "Over 9 levels deep, aborting normalization",
                  "wfs": "Over 9 levels deep, aborting normalization",
                  "explains": "Over 9 levels deep, aborting normalization",
                  "translation": "Over 9 levels deep, aborting normalization",
                  "samples": "Over 9 levels deep, aborting normalization",
                  "us-phonetic": "Over 9 levels deep, aborting normalization",
                  "antonym": "Over 9 levels deep, aborting normalization",
                  "uk-phonetic": "Over 9 levels deep, aborting normalization",
                  "synonyms": "Over 9 levels deep, aborting normalization",
                  "phonetic": "Over 9 levels deep, aborting normalization"
                }
              ]
            ]
          ],
          [
          ],
          [
          ],
          [
            [
              "him",
              [
                {
                  "phrases": "Over 9 levels deep, aborting normalization",
                  "query": "Over 9 levels deep, aborting normalization",
                  "explains": "Over 9 levels deep, aborting normalization",
                  "translation": "Over 9 levels deep, aborting normalization",
                  "samples": "Over 9 levels deep, aborting normalization",
                  "us-phonetic": "Over 9 levels deep, aborting normalization",
                  "antonym": "Over 9 levels deep, aborting normalization",
                  "uk-phonetic": "Over 9 levels deep, aborting normalization",
                  "synonyms": "Over 9 levels deep, aborting normalization",
                  "phonetic": "Over 9 levels deep, aborting normalization"
                }
              ]
            ]
          ],
          [
          ],
          [
          ]
        ],
        "origin": "However , in some ways.I am diferent from him.He studies harder than me.He is always one of the top students in the grade.But my PE grades are much better than him.In other ways , we have something in common.For example , both he and I like to laugh and enjoy milk .",
        "sent_id": 1,
        "para_id": 0,
        "errors": [
          [
            "typo",
            4,
            "ways.I",
            "ways"
          ],
          [
            "insertion",
            4,
            ", I"
          ],
          [
            "typo",
            8,
            "him.He",
            "him"
          ],
          [
            "insertion",
            8,
            ". He ."
          ],
          [
            "typo",
            22,
            "grade.But",
            "grade"
          ],
          [
            "insertion",
            22,
            "."
          ],
          [
            "insertion-conjunction",
            22,
            "But"
          ],
          [
            "typo",
            30,
            "him.In",
            "him"
          ],
          [
            "insertion",
            30,
            ". In"
          ],
          [
            "insertion",
            38,
            ". For"
          ]
        ],
        "errors2": [
          {
            "error_type": "typo",
            "tgt_word": "ways",
            "src_word": "ways.I",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 4
          },
          {
            "error_type": "insertion",
            "tgt_word": ", I",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 4
          },
          {
            "error_type": "typo",
            "tgt_word": "him",
            "src_word": "him.He",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 8
          },
          {
            "error_type": "insertion",
            "tgt_word": ". He .",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 8
          },
          {
            "error_type": "typo",
            "tgt_word": "grade",
            "src_word": "grade.But",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 22
          },
          {
            "error_type": "insertion",
            "tgt_word": ".",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 22
          },
          {
            "error_type": "insertion-conjunction",
            "tgt_word": "But",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 22
          },
          {
            "error_type": "typo",
            "tgt_word": "him",
            "src_word": "him.In",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 30
          },
          {
            "error_type": "insertion",
            "tgt_word": ". In",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 30
          },
          {
            "error_type": "insertion",
            "tgt_word": ". For",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 38
          }
        ]
      },
      {
        "correct": "I have a best friend who has short black hair . And he is a little shorter than me . His eyes are a little small and he wears a pair of glasses . My weight is 54 kg . He is heavier than me . He is as outgoing as me . He is also as old as me .",
        "lexical_knowledge": [
          [
            [
              "hair",
              [
                {
                  "phrases": "Over 9 levels deep, aborting normalization",
                  "query": "Over 9 levels deep, aborting normalization",
                  "wfs": "Over 9 levels deep, aborting normalization",
                  "explains": "Over 9 levels deep, aborting normalization",
                  "translation": "Over 9 levels deep, aborting normalization",
                  "samples": "Over 9 levels deep, aborting normalization",
                  "us-phonetic": "Over 9 levels deep, aborting normalization",
                  "antonym": "Over 9 levels deep, aborting normalization",
                  "uk-phonetic": "Over 9 levels deep, aborting normalization",
                  "synonyms": "Over 9 levels deep, aborting normalization",
                  "phonetic": "Over 9 levels deep, aborting normalization"
                }
              ]
            ]
          ],
          [
          ],
          [
          ],
          [
          ],
          [
          ],
          [
          ],
          [
          ],
          [
          ],
          [
          ]
        ],
        "origin": "I have a best friend who has short black hair.And he is a little shorter than me.His eyes is a little small and he wears a pair of glasses.My weight is 54 kg.He is heavier than me.He is as outgoing as me.He is also as old as me .",
        "sent_id": 0,
        "para_id": 0,
        "errors": [
          [
            "typo",
            9,
            "hair.And",
            "hair"
          ],
          [
            "insertion",
            9,
            "."
          ],
          [
            "insertion-conjunction",
            9,
            "And"
          ],
          [
            "insertion",
            15,
            "me ."
          ],
          [
            "others",
            18,
            "is",
            "are"
          ],
          [
            "typo",
            28,
            "glasses.My",
            "glasses"
          ],
          [
            "insertion",
            28,
            ". My"
          ],
          [
            "insertion",
            32,
            ". He ."
          ],
          [
            "insertion",
            40,
            "me ."
          ]
        ],
        "errors2": [
          {
            "error_type": "typo",
            "tgt_word": "hair",
            "src_word": "hair.And",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 9
          },
          {
            "error_type": "insertion",
            "tgt_word": ".",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 9
          },
          {
            "error_type": "insertion-conjunction",
            "tgt_word": "And",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 9
          },
          {
            "error_type": "insertion",
            "tgt_word": "me .",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 15
          },
          {
            "error_type": "others",
            "tgt_word": "are",
            "src_word": "is",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 18
          },
          {
            "error_type": "typo",
            "tgt_word": "glasses",
            "src_word": "glasses.My",
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 28
          },
          {
            "error_type": "insertion",
            "tgt_word": ". My",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 28
          },
          {
            "error_type": "insertion",
            "tgt_word": ". He .",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 32
          },
          {
            "error_type": "insertion",
            "tgt_word": "me .",
            "src_word": null,
            "tgt_POS": null,
            "src_POS": null,
            "src_position": 40
          }
        ]
      }
    ]
  },
  "ret_time": "2020-10-11 17:47:05.501",
  "request": {
    "app_id": "a111",
    "user_id": "full_chain_test",
    "warrant_id": "5f9a82390c614e0fa0dbe4f51f019",
    "question_type": "custom",
    "essay_content": "I have a best  friend who has short black hair.And he is a little shorter than me.His eyes is a little small and he wears a pair of glasses.My weight is 54 kg.He is heavier than me.He is as outgoing as me.He is also as old as me. However,in some ways.I am diferent from him.He studies harder than me.He is always one of the top students in the grade.But my PE grades are much better than him.In other ways,we have something in common.For example,both he and I like to laugh and enjoy milk.All in all,he is a good friend.I like staying with him.",
    "essay_id": "0000",
    "lowest_words": "50",
    "study_phase": "1100",
    "main_point": ""
  },
  "record_id": "11ebb809cee4t5871f782",
  "request_id": 717095756,
  "uri": "/api/v3/essayEvalute"
}

错误码

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