外观
英文作文批改(图像识别-高级版) API 简介
说明
Hi,您好,欢迎使用有道智云英文作文批改(图像识别-高级版)API 接口服务。
本文档主要针对需要集成 HTTP API 的技术开发工程师,详细描述英文作文批改(图像识别-高级版)能力相关的技术内容。
如果您有与我们商务合作的需求,可以通过以下方式联系我们:
商务邮箱: AIcloud_Business@corp.youdao.com
如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:
客服 QQ:1906538062
智云作文批改技术交流 QQ 1 群: 1092639188
联系邮箱: zhiyun@corp.youdao.com
温馨提示:
本文档主要针对开发人员,接入测试前需要获取应用 ID 和应用密钥;如果您还没有,请按照 新手指南 获取。 平台向每个账户赠送 50 元的体验金,供用户集成前测试所用,具体资费规则详见 英文作文批改服务报价 。
接口说明
有道 AI 团队自研的基于深度学习网络技术的自动作文批改技术。覆盖学生英语学习全周期,提供高参考价值的智能批改功能,用户只需要输入一篇英文作文,选择对应的英文级别,智能批改服务即可一键给出文章得分、整体评价、拼写错误反馈、语法错误反馈、主题相关度反馈、以及高级词汇和推荐词组等一系列结果,从而向用户提供针对性的作文指导意见。
注意:该接口主要针对手写体文章, 自动识别手写体作文和印刷体的题目。
请求地址
英文作文批改(图像识别-高级版) API HTTPS 地址:
协议须知
调用方在集成文本翻译 API 时,请遵循以下规则。
| 规则 | 描述 |
|---|---|
| 传输方式 | HTTPS |
| 求方式 | POST |
| 字符编码 | 统一使用 UTF-8 编码 |
| 请求格式 | 表单 |
| 响应格式 | JSON |
请求参数
| 字段名 | 含义 | 备注 | 必填 |
|---|---|---|---|
| appKey | 应用标识(应用 ID) | **** 325f2a1d4**** | true |
| curtime | 时间戳 | 当前UTC时间戳(秒) | true |
| q | 正文文本 | 图片文本 | true |
| salt | 随机字符串 | 推荐使用uuid确保唯一性 | true |
| sign | 签名信息:sha256(appKey+input+salt+密钥) | sha256(appKey+input+salt+密钥) | true |
| signType | 签名类型 | v3 | true |
| grade | 作文等级 | 取值见grade | false |
| title | 作文标题和题目要求 | 标题内容+题目要求,5000字符以内 | false |
| needEnhancement | 是否启用作文批改增强(好句、更多表达、逻辑衔接提升、内容提升、题目专属语料) | 默认为 false(true/false),为 true 时返回对应增强字段 | false |
| isNeedEssayReport | 是否返回写作报告(essayReport字段,仅在高级批改时生效) | 默认为 false(true/false) | false |
| needModelEssay | 是否需要生成范文 | 默认为 false(true/false) | false |
签名生成算法如下:
signType=v3,sha256(应用 ID+input+salt+curtime+密钥),推荐使用 sha256 签名计算方法为:sha256(应用 ID+input+salt+当前 UTC 时间戳+密钥)。
其中,input 的计算方式为:input=多个q拼接后前10个字符 + 多个q拼接长度 + 多个q拼接后十个字符(当多个 q 拼接后长度大于 20)或 input=多个q拼接的字符串(当多个 q 拼接后长度小于等于 20)。
不同语言获取时间戳,请参看此链接
如果对签名有疑问,可以参看各语言 demo。
服务配置
| 服务内容 | 说明 |
|---|---|
| 图像识别 | 支持 jpg/png/bmp 格式,base64 编码后进行 urlencode,要求 base64 编码 后大小不超过 4M,最短边至少 15px,最长边最大 4096px |
grade取值
| 学级 | 代码 | 分数 |
|---|---|---|
| 不考虑级别,单纯评价句子好坏 | default | 100 |
| 小学 | elementary | 100 |
| 初中 | junior | 100 |
| 高中 | high | 25 |
| 高中读后续写(要求150词) | high_writeAfterRead | 25 |
| 高中短应用文(要求80词) | high_short | 15 |
| 四级 | cet4 | 106.5 |
| 六级 | cet6 | 106.5 |
| 考研英语(一)大作文 | graduate_b1 | 20 |
| 考研英语(一)小作文 | graduate_a1 | 10 |
| 考研英语(二)小作文 | graduate_a2 | 10 |
| 考研英语(二)大作文 | graduate_b2 | 15 |
| 托福-独立写作 | toefl_independent | 30 |
| 托福-综合写作 | toefl_comprehensive | 30 |
| GRE | gre | 6 |
| 雅思-task1 | ielts_task1 | 9 |
| 雅思-task2 | ielts_task2 | 9 |
| 学术写作 | academic | 100 |
返回结果
| 参数名称 | 描述 |
|---|---|
| RequestId | 请求Id |
| errorCode | 错误码 |
| Result | 返回结果 |
说明:
needEnhancement=true时,接口额外返回作文批改增强字段,具体字段及位置见下文「作文批改增强返回字段」。title及majorScore中的topicScore/topicAdvice仅在传入title参数时返回;modelEssay(生成范文)仅在needModelEssay=true时返回;essayReport仅在isNeedEssayReport=true时返回。
返回结果
例:
{
"RequestId": "9cd0e024-5927-4c43-8fbf-0d36462cb4ca",
"errorCode": "0",
"Result": {
// 请求原文
"rawEssay": "Actually, it is sort of a fish berry jam. Lots of job loss is just one thing resulting from automation. We do the essential Python on 22nd September 2019. We do an important python on the 22nd of September 2019. We have 5 apples in the important things 5 on Sep 2019.",
// 文章句子数
"sentNum": 5,
// 每个请求独一无二的字符串标识
"uniqueKey": "3b9e61e0-d6c1-4194-8cf6-2c4c9ae209c2",
// 文章最终评价
"essayAdvice": "",
// 文章最终得分
"totalScore": 0,
// 文章最终简短评价
"totalEvaluation": "Excellent!",
// 分项得分与建议(语法/词汇/结构/主题)
"majorScore": {
// 主题评价 (只有设置了title参数才有)
"topicAdvice": "覆盖了续写的核心情节,完整呈现了通过打扫获得入学机会的过程,要点清晰明确。",
// 主题得分 (只有设置了title参数才有)
"topicScore": 19.8,
// 语法评价
"grammarAdvice": "运用了多种句式,语法错误较少,仅个别表达可更精准,整体表意清晰。",
// 语法得分
"grammarScore": 16.7,
// 词汇评价
"wordAdvice": "用词基本准确,能结合语境表达内容,可适当丰富细节词汇让表达更生动。",
// 词汇得分
"wordScore": 16.8,
// 结构评价
"structureAdvice": "两段衔接自然,从抓住机会到展示成果再到获得认可,逻辑连贯流畅。",
// 结构得分
"structureScore": 16.7
},
// 段落数
"paraNum": 1,
// 文章批改结果
"essayFeedback": {
// 句子批改结果,所有的句子都仅有语法错误,语法错误详细说明看下方:语法错误类型详细说明
"sentsFeedback": [
// 第1句话,包含单节点-点击多项替换错误、单节点-展示类型
{
// 原句
"rawSent": "Actually, it is sort of a fish berry jam.",
// 段落id,从0有序编号
"paraId": 0,
// 句子id,从0有序编号
"sentId": 0,
// 本句话中所有的语法错误,包括基础和高级错误
"errorPosInfos": [
// 这是一个单节点-点击多项替换错误
{
// 推荐标识id
"id": 1668590140818,
// 类似下面的isValidSent,判断是否为合法片段(该片段如果语言检测结果与期望不一致,则认为不合法)
"isValidLangChunk": true,
// 发生错误的内容
"orgChunk": "Actually",
// 业务错误一级信息
"errorTypeTitle": "词汇频繁使用",
// orgChunk相对rawSent 起始位置的偏移量
"startPos": 0,
// 错误块修正后的具体内容
"correctChunk": "Actually",
// orgChunk相对rawSent 结束位置的偏移量
"endPos": 8,
// 错误的副标题信息
"cardSubtitle": "替换新单词",
// 错误基本信息
"errBaseInfo": "词汇使用频繁,建议替换新单词",
// 业务划定的错误大类信息
"errToBBasicType": "",
// 错误原因的详细解释(比reason更进一步)
"detailReason": "词汇使用频繁",
// 所有例句
"exampleCases": [],
// 节点类型 1-单节点,2-多节点
"nodeType": 1,
// 结构类型 1-提示类,2-点击单项替换,3-点击多项替换,4-点击选择替换类
"structType": 3,
// 展示类型,1-基础卡片与1.0一致,2-高级卡片
"showType": 2,
// 当nodeType=1,structType=3时,表示多项值
"target": [
"Really",
"Indeed"
]
},
// 这是一个单节点-提示类型错误
{
"id": 1668590140820,
"isValidLangChunk": true,
"orgChunk": "sort of",
"errorTypeTitle": "不必要的修饰词",
"startPos": 16,
"correctChunk": "sort of",
"endPos": 23,
"cardSubtitle": "删除修饰词",
"errBaseInfo": "学术用词具体、简洁,口语化的一些补白词不够正式,表意模糊,建议删除[rValidChunk]",
"errToBBasicType": "",
"detailReason": "学术用词具体、简洁,口语化的一些补白词不够正式,表意模糊",
"knowledgeExp": "学术写作要求用词<b>明确、简洁</b>,类似kind of的补白词模糊性较强,过于口语化,建议删除。",
// 所有例句
"exampleCases": [
{
// 原句
"error": "An oil does not blend with water",
// 例句翻译
"rightTranslate": "油不溶于水。",
// 例句
"right": "Oil does not blend with water."
}
],
"nodeType": 1,
"showType": 2,
"structType": 2,
"target": [],
}
],
// 错误原因反馈,基于errorPosInfos中所有reason字段拼接而成
"sentFeedback": "词汇频繁使用,建议替换新单词;不必要的修饰词,建议删除〖sort of〗",
// 该句子在全文中相对于文章 初始位置的偏移量
"sentStartPos": 0,
// 正确的句子
"correctedSent": "Actually, it is sort of a fish berry jam.",
// 返回是否含有语法错误
"isContainGrammarError": false,
// 返回是否含有typo错误
"isContainTypoError": false,
// 是否为合法句子(合法与否取决于语言检测对该句的语言信息识别结果与期望结果是否一致)
"isValidLangSent": true,
},
// 省略的中间的句子反馈信息
// 第3句话,包含多节点选择替换错误
{
"rawSent": "We do the essential Python on 22nd September 2019.",
"paraId": 0,
"sentId": 2,
"errorPosInfos": [
// 这是一个多节点选择替换错误的其中一个节点
{
"id": 1668590140825,
"isValidLangChunk": true,
"orgChunk": "22nd September",
"errorTypeTitle": "日期表达不一致",
"startPos": 30,
"correctChunk": "{\"DthMonth\":\"22nd September\",\"TheDthofMonth\":\"the 22nd of September\",\"MonthDth\":\"September 22nd\"}",
"endPos": 44,
"cardSubtitle": "使用一致的日期表达",
"errBaseInfo": "上下文日期表达不一致,建议使用一致的日期表达",
"errToBBasicType": "",
"detailReason": "上下文日期表达不一致",
"knowledgeExp": "<b>日期</b>有几种不同表达方式。January 20,January 20th,Jan. 20,以及20 January都是正确的。一篇文章通常<b>保持日期表达一致</b>。",
"exampleCases": [
],
// 多节点的parentId一致
"parentId": "1668590140767",
"nodeType": 2,
// 只有nodeType=2,structType=4,且是日期错误才会出现
// 原片段
"orgDateType": "Dth Month",
"showType": 2,
"structType": 4,
// 只有nodeType=2,structType=4,才会存在
"statInfo": [
{
// 该类型出现的数量
"count": 1,
// 示例,日期类型才会存在
"demo": "5th Dec",
// 类型
"item": "Dth Month"
},
{
"count": 1,
"demo": "The 5th of Dec",
"item": "The Dth of Month"
}
],
}
],
"sentFeedback": "大小写不统一,建议修改大小写;日期表达不一致,建议使用一致的日期表达",
"sentStartPos": 105,
"correctedSent": "We do the essential {\"lower\":\"python\",\"capitalize\":\"Python\"} on {\"DthMonth\":\"22nd September\",\"TheDthofMonth\":\"the 22nd of September\",\"MonthDth\":\"September 22nd\"} 2019.",
"isContainGrammarError": false,
"isContainTypoError": false,
"isValidLangSent": true
},
// 第4句话,包含多节点选择替换错误
{
"rawSent": "We do an important python on the 22nd of September 2019.",
"paraId": 0,
"sentId": 3,
"errorPosInfos": [
// 这是一个多节点选择替换错误的其中一个节点,与第3句话的错误有同样的父parentId
{
"id": 1668590140828,
"isValidLangChunk": true,
"orgChunk": "the 22nd of September",
"orgDateType": "The Dth of Month",
"errorTypeTitle": "日期表达不一致",
"startPos": 29,
"correctChunk": "{\"DthMonth\":\"22nd September\",\"TheDthofMonth\":\"the 22nd of September\",\"MonthDth\":\"September 22nd\"}",
"endPos": 50,
"cardSubtitle": "使用一致的日期表达",
"errBaseInfo": "上下文日期表达不一致,建议使用一致的日期表达",
"errToBBasicType": "",
"detailReason": "上下文日期表达不一致",
"knowledgeExp": "<b>日期</b>有几种不同表达方式。January 20,January 20th,Jan. 20,以及20 January都是正确的。一篇文章通常<b>保持日期表达一致</b>。",
"exampleCases": [],
"parentId": "1668590140767",
"nodeType": 2,
"showType": 2,
"statInfo": [
{
"count": 1,
"demo": "5th Dec",
"item": "Dth Month"
},
{
"count": 1,
"demo": "The 5th of Dec",
"item": "The Dth of Month"
}
],
"structType": 4
}
],
"sentFeedback": "词汇频繁使用,建议替换新单词;大小写不统一,建议修改大小写;日期表达不一致,建议使用一致的日期表达",
"sentStartPos": 156,
"correctedSent": "We do an important {\"lower\":\"python\",\"capitalize\":\"Python\"} on {\"DthMonth\":\"22nd September\",\"TheDthofMonth\":\"the 22nd of September\",\"MonthDth\":\"September 22nd\"} 2019.",
"isContainGrammarError": false,
"isContainTypoError": false,
"isValidLangSent": true
},
// 第5句话,包含单节点点击单项替换错误
{
"rawSent": "We have 5 apples in the important things 5 on Sep 2019.",
"paraId": 0,
"sentId": 4,
"errorPosInfos": [
{
"id": 1668590140830,
"isValidLangChunk": true,
"orgChunk": "5",
"errorTypeTitle": "拼写不统一",
"startPos": 8,
"correctChunk": "five",
"endPos": 9,
"cardSubtitle": "拼写单词",
"errBaseInfo": "阿拉伯数字应该使用英文拼写,建议将[orgChunk]修改为[correctChunk]",
"errToBBasicType": "",
"detailReason": "阿拉伯数字应该使用英文拼写",
"knowledgeExp": "一般来说,<b>0到9的数字</b>都应该<b>拼写</b>出来。如果想要表达日期、地址、金钱、分数、百分比、分数和小数,可以直接使用数字。",
"exampleCases": [],
"nodeType": 1,
"showType": 2,
"structType": 2
}
],
"sentFeedback": "拼写不统一,建议将〖5〗修改为【five】;词汇频繁使用,建议替换新单词",
"sentStartPos": 213,
"correctedSent": "We have five apples in the important things 5 on Sep 2019.",
"isContainGrammarError": true,
"isContainTypoError": false,
"isValidLangSent": true
}
]
},
// 单词数
"wordNum": 0,
// 文章总分
"fullScore": 100,
// 请求学段英文名称
"stLevel": "TASK1",
// 请求标题(仅传入 title 参数时返回)
"title": "yapi-test-1",
// 写作报告,仅 isNeedEssayReport=true 时返回,字段见下方
"essayReport": {}
}
}作文批改增强返回字段(needEnhancement=true)
当请求参数 needEnhancement=true 时,接口在常规批改结果之外额外返回 作文批改增强内容;缺省或为 false 时不返回下列字段。增强能力按学段与作文类型分流:
- 高中读后续写(
grade=high_writeAfterRead):返回「更多表达」「内容提升」「好句好词」。 - 其他学段:返回「更多表达」「逻辑衔接提升」「好句好词」;当
title(题目)有效时,额外返回「题目专属语料」。
好句好词 goodSentences
位于 Result.sentsFeedback[i],标注学生已有亮点:识别复杂句式(非谓语、从句、倒装、强调、with 复合结构、独立主格及自然的并列结构)与恰当的高级词汇/短语:
{
"sentId": 2,
"isGoodSent": true,
"goodSentReason": "自然的非谓语结构",
"hasGoodWords": true,
"goodWords": "a wave of disappointment",
"goodWordsReason": "情绪表达形象准确"
}| 字段名 | 说明 |
|---|---|
| isGoodSent | 是否为好句(true/false) |
| goodSentReason | 好句理由,说明复杂句式或整句亮点(中文,15 字以内) |
| hasGoodWords | 是否包含好词/好短语(true/false) |
| goodWords | 好词或短语,仅 hasGoodWords=true 时有值 |
| goodWordsReason | 好词/短语的表达价值说明(中文,15 字以内),仅 hasGoodWords=true 时有值 |
更多表达 moreExpressions
位于 Result.sentsFeedback[i],逐句将学生原句改写为更准确、自然、有表现力的表达,只返回改写结果:
{
"sentId": 3,
"rawSent": "However, I don't know how to deal with it.",
"moreExpressions": [
{ "upgradedSentence": "However, I find myself at a loss about how to cope with it." }
]
}| 字段名 | 说明 |
|---|---|
| upgradedSentence | 改写后的句子 |
逻辑衔接提升 logicImprovements
仅非高中读后续写返回,位于 Result.sentsFeedback[i];category 只能为「逻辑衔接词」「修饰性从句或短语」「语义承接」:
{
"sentId": 5,
"rawSent": "Try again.",
"logicImprovements": [
{
"rawPrevSentence": "You simply forgot to maintain your balance.",
"rawSentence": "Try again.",
"upgradedSentence": "You simply forgot to maintain your balance, so just try again.",
"category": "逻辑衔接词",
"reason": "添加“so”明确因果衔接,使前后两句逻辑关系更清晰。"
}
]
}| 字段名 | 说明 |
|---|---|
| rawPrevSentence | 前一句原文 |
| rawSentence | 当前句原文 |
| upgradedSentence | 逻辑提升后的句子 |
| category | 提升类别,取值见上 |
| reason | 修改原因说明 |
内容提升 contentImprovements
仅高中读后续写(grade=high_writeAfterRead)返回,位于 Result.sentsFeedback[i];category 为类别, 例:「细节丰富」或「情感深化」:
{
"sentId": 3,
"rawSent": "With eyes full of worries, he started to check if I was hurt.",
"contentImprovements": [
{
"category": "细节丰富",
"upgradedSentence": "With his brows deeply furrowed, Bob crouched down and carefully examined my scraped knees.",
"reason": "补充神态和动作,强化关切感。"
}
]
}| 字段名 | 说明 |
|---|---|
| category | 提升类别:细节丰富 / 情感深化 |
| upgradedSentence | 内容提升后的完整升级句 |
| reason | 教学说明(不超过 30 个中文字符) |
题目专属语料 topicSpecificCorpus
仅非高中读后续写且 title(题目)有效时返回,位于顶层 Result,最多 2 条:
{
"topicSpecificCorpus": [
{
"keyPoint": "对来信者的焦虑表示理解并给予安慰",
"english": "I understand how overwhelming academic pressure can feel, and please remember that these worries are common at this stage of life.",
"translation": "我理解学业压力会让人多么不堪重负,请记住,在人生这个阶段有这些担忧很常见。"
}
]
}| 字段名 | 说明 |
|---|---|
| keyPoint | 写作要点(中文) |
| english | 可直接复用的英文语料(1~3 句) |
| translation | 对应的中文翻译 |
写作报告 essayReport
essayReport 仅在请求参数 isNeedEssayReport=true 时返回。其中与 Result 顶层重复的字段(essayAdvice、totalScore、paraNum、sentNum、fullScore、conjWordNum、majorScore)不再重复列出,此处只展示 essayReport 独有的统计字段:
{
"essayReport": {
// 平均句长
"avgSentLen": 17.1,
// 平均句长建议
"avgSentLenAdvice": "文章平均句长为17.1,达到四级优秀作文平均句长。",
// 平均词长
"avgWordLen": 4.8,
// 平均词长建议
"avgWordLenAdvice": "平均词长代表了文章单词的平均长度。\n文章平均词长为4.8,达到四级优秀作文平均词长。",
// 字符数
"charNum": 1013,
// 文章连接词建议
"conjAdvice": {
// 需要将占位符替换的值列表
"fillers": [
6,
[
"并列",
"因果",
"顺序"
]
],
// 建议,包括占位符字段
"original": "文章行文连贯,衔接手段运用自如,段落间逻辑紧密层次分明,实为佳作!\n文中共使用了%s种逻辑连接词,使用较多的有表示%s关系的逻辑连接词。合理运用逻辑连接词可增强文章的连贯性与逻辑性,建议适当积累一些逻辑连接词。",
// 占位符
"placeholder": "%s"
},
// 逻辑连接词,按比例从降序排序
"conjTypeInfos": [
{
// 数量
"count": 4,
// 名称
"name": "并列",
// 比例
"percent": 0.29
},
{
"count": 4,
"name": "因果",
"percent": 0.29
},
{
"count": 2,
"name": "顺序",
"percent": 0.14
},
{
"count": 2,
"name": "让步",
"percent": 0.14
},
{
"count": 1,
"name": "递进",
"percent": 0.07
},
{
"count": 1,
"name": "其他",
"percent": 0.07
}
],
// 逻辑连接词数量
"conjWordNum": 7,
// 语法错误建议
"grammarErrorAdvice": {
// 建议
"advice": "建议复习相关语法知识。",
// 所有的语法错误,按比例降序排序
"errors": [
{
// 出现次数
"count": 12,
// 错误类型
"name": "词汇拼写错误",
// 出现比例,二位小数
"percent": 0.33
},
{
"count": 7,
"name": "词汇使用错误",
"percent": 0.2
},
{
"count": 4,
"name": "固定搭配介词错误",
"percent": 0.11
},
{
"count": 3,
"name": "名词单复数错误",
"percent": 0.09
},
{
"count": 2,
"name": "限定词缺失",
"percent": 0.06
},
{
"count": 7,
"name": "其他",
"percent": 0.21
}
],
// 评价
"evaluation": "整体语法错误较多,高频语法错误有",
// 高频的语法错误
"highFreqErrors": [
"词汇拼写错误",
"词汇使用错误"
]
},
// 真正的语法错误数量
"grammarErrorNum": 23,
// 词汇水平分布信息,占比保留3位小数
"lexicalDistribution": {
// 词汇水平分布建议
"advice": "您的文章与<span>优秀四级</span>作文平均词汇分布相比:使用的词汇水平有限,词汇分布合理,满足考试的需求,建议继续通过写作练习词汇和表达哦!",
//小学词汇数量
"primaryWordNum": 0,
//小学词汇数量占比
"primaryWordNumPercent": 0.000,
//初中词汇数量
"juniorWordNum": 0,
//初中词汇数量占比
"juniorWordNumPercent": 0.000,
//高中词汇数量
"seniorWordNum": 0,
//高中词汇数量占比
"seniorWordNumPercent": 0.000,
//四级词汇数量
"cet4WordNum": 0,
//四级词汇数量占比
"cet4WordNumPercent": 0.000,
//六级词汇数量
"cet6WordNum": 0,
//六级词汇数量占比
"cet6WordNumPercent": 0.000,
//托福词汇数量
"toeflAndIeltsWordNum": 0,
//托福词汇数量占比
"toeflAndIeltsWordNumPercent": 0.000
},
// 原文长度(含空格与标点等字符)
"rawLength": 1024,
// 句子成分
"sentComplexInfo": {
// 复杂句数量
"complexSentNum": 6,
// 复杂句百分比
"complexSentPercent": 0.5,
// 句子评价建议
"sentenceStructureAdvice": "简单句与复杂句均能综合使用,句子结构较为合理。",
// 简单句数量
"simpleSentNum": 6,
// 简单句百分比
"simpleSentPercent": 0.5
},
// 句长丰富度
"stdSentLen": 7.9,
// 句长丰富度建议,计算结果
"stdSentLenAdvice": "句长丰富度会影响文章结构分。\n文章句长丰富度为7.9,达到四级优秀作文句长丰富度,文章读起来比较生动。",
// 单词数(统计口径与 Result.wordNum 不同,以 essayReport 为准更接近正文)
"wordNum": 178
}
}错误代码列表
| 错误码 | 含义 |
|---|---|
| 101 | 缺少必填的参数,首先确保必填参数齐全,然后,确认参数书写是否正确。 |
| 102 | 不支持的语言类型 |
| 103 | 翻译文本过长 |
| 104 | 不支持的API类型 |
| 105 | 不支持的签名类型 |
| 106 | 不支持的响应类型 |
| 107 | 不支持的传输加密类型 |
| 108 | 应用ID无效,注册账号,登录后台创建应用,可获得应用ID和应用密钥等信息 |
| 109 | batchLog格式不正确 |
| 110 | 无相关服务的有效应用,。注:某些服务的结果发音需要tts服务,需要在控制台创建语音合成实例绑定应用后方能使用。 |
| 111 | 开发者账号无效 |
| 112 | 请求服务无效 |
| 113 | q不能为空 |
| 114 | 不支持的图片传输方式 |
| 201 | 解密失败,可能为DES,BASE64,URLDecode的错误 |
| 202 | 签名检验失败,如果确认应用ID和应用密钥的正确性,仍返回202,一般是编码问题。请确保翻译文本 q 为UTF-8编码. |
| 203 | 访问IP地址不在可访问IP列表 |
| 205 | 请求的接口与应用的平台类型不一致,确保接入方式(Android SDK、IOS SDK、API)与创建的应用平台类型一致。如有疑问请参考入门指南 |
| 206 | 因为时间戳无效导致签名校验失败 |
| 207 | 重放请求 |
| 301 | 辞典查询失败 |
| 302 | 翻译查询失败 |
| 303 | 服务端的其它异常 |
| 304 | 会话闲置太久超时 |
| 401 | 账户已经欠费停 |
| 402 | offlinesdk不可用 |
| 411 | 访问频率受限,请稍后访问 |
| 412 | 长请求过于频繁,请稍后访问 |
| 29001 | inputType 类型不对 |
| 29002 | needTypo 类型不对 |
| 29003 | Q 超过限制长度 |
| 29004 | grade 类型不对 |
| 29005 | 文件为空 |
| 29006 | 图片过大 |
| 29007 | 作文批改的文本内容为空 |
| 29009 | ocr识别结果为空 |
| 29301 | 作文批改请求失败 |
