纯文本英语作文批改

最近更新时间:2019-05-30 21:59:55

1. 接口描述

接口请求域名: ecc.tencentcloudapi.com 。

接口请求域名: ecc.tencentcloudapi.com 纯文本英语作文批改

默认接口请求频率限制:1000次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:ECC
Version String 公共参数,本接口取值:2018-12-13
Region String 公共参数,本接口不需要传递此参数。
Content String 作文文本,必填
Title String 作文题目,可选参数
Grade String 年级标准, 默认以cet4为标准,取值与意义如下:elementary 小学,grade7 grade8 grade9分别对应初一,初二,初三。 grade10 grade11 grade12 分别对应高一,高二,高三,以及cet4和cet6 分别表示 英语4级和6级。
Outline String 作文提纲,可选参数,作文的写作要求。
ModelSubject String 范文标题,可选参数,本接口可以依据提供的范文对作文进行评分。
ModelContent String 范文内容,可选参数,同上,范文的正文部分。

3. 输出参数

参数名称 类型 描述
Data CorrectData 整体的批改结果
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 纯文本英语作文批改

输入示例

https://ecc.tencentcloudapi.com/?Action=ECC
&Grade=
&Outline=
&ModelSubject=
&ModelContent=
&Title=
&Content=this composition content
&<公共请求参数>

输出示例

{
  "Response": {
    "Data": {
      "Score": 78.6,
      "ScoreCat": {
        "Words": {
          "Name": "词汇",
          "Score": 80.63
        },
        "Sentences": {
          "Name": "句子",
          "Score": 63.55
        },
        "Structure": {
          "Name": "篇章结构",
          "Score": 88.22
        },
        "Content": {
          "Name": "内容",
          "Score": 95.0
        }
      },
      "Comment": "用词灵活多样,也能较灵活地使用一些高级词汇;可适当增加复合句和从句的使用;文中衔接词丰富。请注意针对性练习,更上一层楼。",
      "SentenceComments": [
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "冠词错误",
              "Origin": "a",
              "Replace": "an",
              "Message": "[冠词错误]错误:a,不定冠词后单词是元音开头,请使用an。"
            },
            {
              "Type": "Error",
              "ErrorType": "拼写错误",
              "Origin": "internationaly",
              "Replace": "international/internationally/internationals/Internationale/international y",
              "Message": "[拼写错误]错误:internationaly,拼写错误,建议修改为:international/internationally/internationals/Internationale/international y。"
            }
          ],
          "Sentence": {
            "Sentence": "English is a internationaly language which becomes importantly for modern world. ",
            "ParaID": 1,
            "SentenceID": 1
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "语法错误",
              "Origin": "took",
              "Replace": "taken",
              "Message": "[语法错误]错误:took,建议修改为过去分词形式:taken。"
            },
            {
              "Type": "Error",
              "ErrorType": "拼写错误",
              "Origin": "foreigh",
              "Replace": "foreign/forage",
              "Message": "[拼写错误]错误:foreigh,拼写错误,建议修改为:foreign/forage。"
            },
            {
              "Type": "Error",
              "ErrorType": "单复数错误",
              "Origin": "many student",
              "Replace": "many students",
              "Message": "[单复数错误]错误:many student,单复数错误,student可数,建议修改为many students。"
            },
            {
              "Type": "Error",
              "ErrorType": "拼写错误",
              "Origin": "choosed",
              "Replace": "chose/choose/chooses/chooser/choose d",
              "Message": "[拼写错误]错误:choosed,拼写错误,建议修改为:chose。"
            }
          ],
          "Sentence": {
            "Sentence": "In China, English is took to be a foreigh language which many student choosed to learn. ",
            "ParaID": 1,
            "SentenceID": 2
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "冠词错误",
              "Origin": "a",
              "Replace": "an",
              "Message": "[冠词错误]错误:a,不定冠词后单词是元音开头,请使用an。"
            }
          ],
          "Sentence": {
            "Sentence": "They begin to studying English at a early age. ",
            "ParaID": 1,
            "SentenceID": 3
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "拼写错误",
              "Origin": "knowledges",
              "Replace": "knowledge/know ledges/knowledge s",
              "Message": "[拼写错误]错误:knowledges,拼写错误,建议修改为:knowledge/know ledges/knowledge s。"
            }
          ],
          "Sentence": {
            "Sentence": "They use at least one hour to learn English knowledges a day. ",
            "ParaID": 1,
            "SentenceID": 4
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "拼写错误",
              "Origin": "phenomenan",
              "Replace": "phenomenon/phenomena/phenomenal/phenomena n",
              "Message": "[拼写错误]错误:phenomenan,拼写错误,建议修改为:phenomenon/phenomena/phenomenal/phenomena n。"
            }
          ],
          "Sentence": {
            "Sentence": "That's a good phenomenan, for English is essential nowadays. ",
            "ParaID": 1,
            "SentenceID": 6
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "比较级错误",
              "Origin": "superior than",
              "Replace": "superior to",
              "Message": "[比较级错误]错误:superior than,部分形容词本身具有比较级的意思,这些词语搭配to使用。,建议修改为:superior to。"
            }
          ],
          "Sentence": {
            "Sentence": "In addition to, some people think English is superior than Chinese. ",
            "ParaID": 1,
            "SentenceID": 7
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "拼写错误",
              "Origin": "it",
              "Replace": "It",
              "Message": "[拼写错误]错误:it,句子首单词要大写,建议修改为:It。"
            }
          ],
          "Sentence": {
            "Sentence": "it is hard for people to see eye to eye. ",
            "ParaID": 1,
            "SentenceID": 9
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "语法错误",
              "Origin": "learn",
              "Replace": "learned/learnt",
              "Message": "[语法错误]错误:learn,建议修改为过去分词形式:learned,learnt。"
            }
          ],
          "Sentence": {
            "Sentence": "Learning a country's culture, especial its classic culture, the first thing is learn its language. ",
            "ParaID": 1,
            "SentenceID": 12
          }
        },
        {
          "Suggestions": [
            {
              "Type": "Error",
              "ErrorType": "语法错误",
              "Origin": "Because of we",
              "Replace": "Because we",
              "Message": "[语法错误]错误:Because of we,短语用法错误,请使用:Because we。"
            },
            {
              "Type": "Error",
              "ErrorType": "拼写错误",
              "Origin": "owne",
              "Replace": "one/own/owned/owner/owns",
              "Message": "[拼写错误]错误:owne,拼写错误,建议修改为:one/own/owned/owner/owns。"
            }
          ],
          "Sentence": {
            "Sentence": "Because of we are Chinese, why do we give up our mother tongue and learn our owne culture through a foreign language?",
            "ParaID": 1,
            "SentenceID": 13
          }
        }
      ]
    },
    "RequestId": "ae5d82c1-47a1-43c0-b8a2-4d3c35a21488"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
InternalError.CorrectError 批改错误。
InvalidParameter.InputError 传入的参数有误。