英文作文批改(文本輸入) API 簡(jiǎn)介
說(shuō)明
Hi,您好,歡迎使用有道智云英文作文批改(文本輸入)API 接口服務(wù)。
本文檔主要針對(duì)需要集成 HTTP API 的技術(shù)開(kāi)發(fā)工程師,詳細(xì)描述英文作文批改(文本輸入)能力相關(guān)的技術(shù)內(nèi)容。
如果您有與我們商務(wù)合作的需求,可以通過(guò)以下方式聯(lián)系我們:
商務(wù)郵箱: AIcloud_Business@corp.youdao.com
如果您對(duì)文檔內(nèi)容有任何疑問(wèn),可以通過(guò)以下幾種方式聯(lián)系我們:
客服 QQ:1906538062
智云作文批改技術(shù)交流 QQ 1 群: 1092639188
聯(lián)系郵箱: zhiyun@corp.youdao.com
溫馨提示:
本文檔主要針對(duì)開(kāi)發(fā)人員,接入測(cè)試前需要獲取應(yīng)用 ID 和應(yīng)用密鑰;如果您還沒(méi)有,請(qǐng)按照 新手指南 獲取。
平臺(tái)向每個(gè)賬戶贈(zèng)送 50 元的體驗(yàn)金,供用戶集成前測(cè)試所用,具體資費(fèi)規(guī)則詳見(jiàn) 英文作文批改服務(wù)報(bào)價(jià) 。
接口說(shuō)明
有道 AI 團(tuán)隊(duì)自研的基于深度學(xué)習(xí)網(wǎng)絡(luò)技術(shù)的自動(dòng)作文批改技術(shù)。覆蓋學(xué)生英語(yǔ)學(xué)習(xí)全周期,提供高參考價(jià)值的智能批改功能,用戶只需要輸入一篇英文作文,選擇對(duì)應(yīng)的英文級(jí)別,智能批改服務(wù)即可一鍵給出文章得分、整體評(píng)價(jià)、拼寫(xiě)錯(cuò)誤反饋、語(yǔ)法錯(cuò)誤反饋、主題相關(guān)度反饋、以及高級(jí)詞匯和推薦詞組等一系列結(jié)果,從而向用戶提供針對(duì)性的作文指導(dǎo)意見(jiàn)。
請(qǐng)求地址
https://openapi.youdao.com/v2/correct_writing_text
協(xié)議須知
調(diào)用方在集成文本翻譯 API 時(shí),請(qǐng)遵循以下規(guī)則。
規(guī)則 | 描述 |
---|
傳輸方式 | HTTPS |
求方式 | POST |
字符編碼 | 統(tǒng)一使用 UTF-8 編碼 |
請(qǐng)求格式 | 表單 |
響應(yīng)格式 | JSON |
請(qǐng)求參數(shù)
字段名 | 含義 | 備注 | 必填 |
---|
appKey | 應(yīng)用標(biāo)識(shí)(應(yīng)用 ID) | 控制臺(tái)獲取 | true |
curtime | 時(shí)間戳 | 當(dāng)前UTC時(shí)間戳(秒) | true |
q | 正文文本 | 作文內(nèi)容文本 | true |
salt | 隨機(jī)字符串 | 推薦使用uuid確保唯一性 | true |
sign | 簽名信息:sha256(appKey+input+salt+密鑰) | sha256(appKey+input+salt+密鑰) | true |
signType | 簽名類型 | v3 | true |
grade | 作文等級(jí) | 參考grade | false |
title | 作文標(biāo)題 | 標(biāo)題內(nèi)容 | false |
modelContent | 作文參考范文 | 參考范文,長(zhǎng)度限制為[0,5000] | false |
isNeedSynonyms | 是否查詢同義詞 | 默認(rèn)為 false(true/false) | false |
correctVersion | 作文批改版本:基礎(chǔ),高級(jí) | 默認(rèn)為 basic(basic/advanced)返回結(jié)果見(jiàn)示例 | false |
isNeedEssayReport | 是否返回寫(xiě)作報(bào)告(essayReport字段,僅在高級(jí)批改時(shí)生效) | 默認(rèn)為 false(true/false) | false |
最好傳輸 limitedWords,這樣評(píng)分更精確。
簽名生成算法如下:
signType=v3,sha256(應(yīng)用 ID+input+salt+curtime+密鑰),推薦使用
sha256 簽名計(jì)算方法為:sha256(應(yīng)用 ID+input+salt+當(dāng)前 UTC 時(shí)間戳+密鑰)。
其中,input 的計(jì)算方式為:input=多個(gè)q拼接后前10個(gè)字符 + 多個(gè)q拼接長(zhǎng)度 + 多個(gè)q拼接后十個(gè)字符(當(dāng)多個(gè) q 拼接后長(zhǎng)度大于 20)或 input=多個(gè)q拼接的字符串(當(dāng)多個(gè) q 拼接后長(zhǎng)度小于等于 20)。
不同語(yǔ)言獲取時(shí)間戳,請(qǐng)參看此鏈接
如果對(duì)簽名有疑問(wèn),可以參看各語(yǔ)言 demo。
grade取值
學(xué)級(jí) | 代碼 | 分?jǐn)?shù) |
---|
不考慮級(jí)別,單純?cè)u(píng)價(jià)句子好壞 | default | 100 |
小學(xué) | elementary | 100 |
初中 | junior | 100 |
高中 | high | 25 |
四級(jí) | cet4 | 106.5 |
六級(jí) | cet6 | 106.5 |
考研 | graduate | 20 |
考研英語(yǔ)(一)大作文 | graduate_b1 | 20 |
考研英語(yǔ)(一)小作文 | graduate_a1 | 10 |
考研英語(yǔ)(二)小作文 | graduate_a2 | 10 |
考研英語(yǔ)(二)大作文 | graduate_b2 | 15 |
托福 | toefl | 30 |
托福-獨(dú)立寫(xiě)作 | toefl_independent | 30 |
托福-綜合寫(xiě)作 | toefl_comprehensive | 30 |
考研 | graduate | 20 |
GRE | gre | 6 |
雅思 | ielts | 9 |
雅思-task1 | ielts_task1 | 9 |
雅思-task2 | ielts_task2 | 9 |
學(xué)術(shù)寫(xiě)作 | academic | 100 |
同義詞推薦類型信息
編碼 | 名稱 | 解釋 |
---|
1 | LEXICAL | 詞級(jí)近義推薦 |
2 | PHRASE | 不合適的搭配 |
3 | VERY | 固定搭配 |
返回結(jié)果
參數(shù)名稱 | 描述 |
---|
RequestId | 請(qǐng)求Id |
errorCode | 錯(cuò)誤碼 |
Result | 返回結(jié)果 |
服務(wù)配置
服務(wù)內(nèi)容 | 說(shuō)明 |
---|
文本輸入 | 最大支持 5000 字符 |
錯(cuò)誤代碼列表
錯(cuò)誤碼 | 含義 |
---|
101 | 缺少必填的參數(shù),首先確保必填參數(shù)齊全,然后,確認(rèn)參數(shù)書(shū)寫(xiě)是否正確。 |
102 | 不支持的語(yǔ)言類型 |
103 | 翻譯文本過(guò)長(zhǎng) |
104 | 不支持的API類型 |
105 | 不支持的簽名類型 |
106 | 不支持的響應(yīng)類型 |
107 | 不支持的傳輸加密類型 |
108 | 應(yīng)用ID無(wú)效,注冊(cè)賬號(hào),登錄后臺(tái)創(chuàng)建應(yīng)用,可獲得應(yīng)用ID和應(yīng)用密鑰等信息 |
109 | batchLog格式不正確 |
110 | 無(wú)相關(guān)服務(wù)的有效應(yīng)用,。注:某些服務(wù)的結(jié)果發(fā)音需要tts服務(wù),需要在控制臺(tái)創(chuàng)建語(yǔ)音合成實(shí)例綁定應(yīng)用后方能使用。 |
111 | 開(kāi)發(fā)者賬號(hào)無(wú)效 |
112 | 請(qǐng)求服務(wù)無(wú)效 |
113 | q不能為空 |
114 | 不支持的圖片傳輸方式 |
201 | 解密失敗,可能為DES,BASE64,URLDecode的錯(cuò)誤 |
202 | 簽名檢驗(yàn)失敗,如果確認(rèn)應(yīng)用ID和應(yīng)用密鑰的正確性,仍返回202,一般是編碼問(wèn)題。請(qǐng)確保翻譯文本 q 為UTF-8編碼. |
203 | 訪問(wèn)IP地址不在可訪問(wèn)IP列表 |
205 | 請(qǐng)求的接口與應(yīng)用的平臺(tái)類型不一致,確保接入方式(Android SDK、IOS SDK、API)與創(chuàng)建的應(yīng)用平臺(tái)類型一致。如有疑問(wèn)請(qǐng)參考入門指南 |
206 | 因?yàn)闀r(shí)間戳無(wú)效導(dǎo)致簽名校驗(yàn)失敗 |
207 | 重放請(qǐng)求 |
301 | 辭典查詢失敗 |
302 | 翻譯查詢失敗 |
303 | 服務(wù)端的其它異常 |
304 | 會(huì)話閑置太久超時(shí) |
401 | 賬戶已經(jīng)欠費(fèi)停 |
402 | offlinesdk不可用 |
411 | 訪問(wèn)頻率受限,請(qǐng)稍后訪問(wèn) |
412 | 長(zhǎng)請(qǐng)求過(guò)于頻繁,請(qǐng)稍后訪問(wèn) |
29001 | inputType 類型不對(duì) |
29002 | needTypo 類型不對(duì) |
29003 | Q 超過(guò)限制長(zhǎng)度 |
29004 | grade 類型不對(duì) |
29005 | 文件為空 |
29006 | 圖片過(guò)大 |
29007 | 作文批改的文本內(nèi)容為空 |
29008 | isNeedSynonyms參數(shù)錯(cuò)誤 |
29009 | ocr識(shí)別結(jié)果為空 |
29301 | 作文批改請(qǐng)求失敗 |
基礎(chǔ)版basic
例:
{
"RequestId": "9cd0e024-5927-4c43-8fbf-0d36462cb4ca",
"errorCode": "0",
"Result": {
// 請(qǐng)求原文
"rawEssay": "Nowadays, more and more middle-aged people are suffering from insomnia, as life for the middle-aged is stressful indeed. For one thing, as they are the backbones of their companies, they have plenty of things to do at work. And they usually have to work overtime. For another, they have to take great responsibilities at home, for their aged parents need to be supported and their little children need to be brought up. That's why they don't have enough time to have a good rest.To sleep well, some of them often take sleeping pills. I don't think it's good for them to do so, because the sleeping pills can only get rid of the sign of insomnia, not the cause. And taking too much sleeping pills is bad for their health.Therefore, I suggest those middle-aged people should know how to relax themselves and rest their brains. Taking a simple work after supper will be beneficial for them. Besides, they can have a glass of milk before going to bed, which can be helpful for their sleep.",
// 文章句子數(shù)
"sentNum": 11,
// 每個(gè)請(qǐng)求獨(dú)一無(wú)二的字符串標(biāo)識(shí)
"uniqueKey": "46df4a57-1804-404f-985c-898401dfe1ab",
// 文章最終評(píng)價(jià)
"essayAdvice": "作文整體水平較高",
// 文章最終得分
"totalScore": 93,
// 文章最終簡(jiǎn)短評(píng)價(jià)
"totalEvaluation": "Excellent!",
// 語(yǔ)言信息
"essayLangName": "English",
// 是AllFeatureScore中score整合結(jié)果
"majorScore": {
// 語(yǔ)法得分:包括拼寫(xiě)、語(yǔ)法、句子復(fù)雜度得分等
"grammarScore": 89.8,
// 語(yǔ)法評(píng)價(jià)
"grammarAdvice": "存在少量語(yǔ)法錯(cuò)誤,建議認(rèn)真檢查",
// 內(nèi)容(主題相關(guān)性)得分,如果沒(méi)有參考范文,該部分得分會(huì)從語(yǔ)法和復(fù)雜度上考慮
"topicScore": 66.2,
// 詞匯得分:包括詞數(shù)、豐富度、高級(jí)詞匯等得分
"wordScore": 89,
// 詞匯評(píng)價(jià)
"wordAdvice": "單詞拼寫(xiě)基本正確,單詞拼寫(xiě)基礎(chǔ)扎實(shí);詞匯量較為豐富,能使用一定數(shù)量的高級(jí)詞匯",
// 邏輯得分:包括段落和連接詞得分
"structureScore": 88.3,
// 邏輯評(píng)價(jià)
"structureAdvice": "邏輯性不錯(cuò),上下文關(guān)系銜接較為緊密"
},
// 段落數(shù)
"paraNum": 1,
// 文章批改結(jié)果
"essayFeedback": {
// 句子批改結(jié)果
// 每個(gè)句子的批改結(jié)果當(dāng)errorPosInfos不為空數(shù)組時(shí),synInfo==null,errorPosInfos為空數(shù)組時(shí),且isNeedSynonyms=true synInfo可能存在
"sentsFeedback": [
// 第1句話,沒(méi)有任何錯(cuò)誤和同義詞推薦信息
{
// 原句
"rawSent": "Nowadays, more and more middle-aged people are suffering from insomnia, as life for the middle-aged is stressful indeed.",
// 段落id,從0有序編號(hào)
"paraId": 0,
// 句子id,從0有序編號(hào)
"sentId": 0,
// 本句話中所有的語(yǔ)法錯(cuò)誤
"errorPosInfos": [],
// 本句話中所有的同義詞推薦
"synInfo": null,
// 錯(cuò)誤原因反饋,基于errorPosInfos中所有reason字段拼接而成
"sentFeedback": "",
// 該句子在全文中相對(duì)于文章 初始位置的偏移量
"sentStartPos": 0,
// 正確的句子
"correctedSent": "Nowadays, more and more middle-aged people are suffering from insomnia, as life for the middle-aged is stressful indeed.",
// 返回是否含有語(yǔ)法錯(cuò)誤
"isContainGrammarError": false,
// 返回是否含有typo錯(cuò)誤
"isContainTypoError": false,
// 是否為合法句子(合法與否取決于語(yǔ)言檢測(cè)對(duì)該句的語(yǔ)言信息識(shí)別結(jié)果與期望結(jié)果是否一致)
"isValidLangSent": true
},
// 第2句話,有同義詞推薦信息
{
"rawSent": "For one thing, as they are the backbones of their companies, they have plenty of things to do at work.",
"paraId": 0,
"sentId": 1,
"errorPosInfos": [],
"synInfo": [
{
// 推薦標(biāo)識(shí)id
"id": 1667303677314,
// 核心詞詞性
"sourcePos": "名詞",
// 核心詞類型,類型可看上方
"synType": "LEXICAL",
// 核心詞解釋
"sourceTran": "n. 公司,企業(yè);演出團(tuán),歌舞團(tuán);連隊(duì)(company 的復(fù)數(shù)); v. 陪伴,伴隨(company 的第三人稱單數(shù))",
// 核心詞一些標(biāo)簽,目前僅有核心詞詞性
"tagList": [
"名詞"
],
// 推薦標(biāo)識(shí)有序id
"synId": 0,
// 核心詞信息,核心詞可能由多個(gè)組成
"source": [
{
// 當(dāng)前詞相對(duì)于當(dāng)前句子 初始的偏移量
"startPos": 50,
// 當(dāng)前詞相對(duì)于當(dāng)前句子 結(jié)束的偏移量
"endPos": 59,
// 當(dāng)前詞
"word": "companies",
// 當(dāng)前詞學(xué)段,可能有多個(gè),學(xué)段信息等同入?yún)tLevel列表
"stuLevel": [
2
]
}
],
// 候選詞信息,有多個(gè)候選詞
"target": [
// 第一個(gè)候選詞,每一個(gè)候選詞都可能由多個(gè)詞組成
[
{
// 當(dāng)前詞相對(duì)于當(dāng)前句子 初始的偏移量
"startPos": 50,
// 當(dāng)前詞相對(duì)于當(dāng)前句子 結(jié)束的偏移量
"endPos": 59,
// 當(dāng)前詞
"word": "firms",
// 當(dāng)前詞解釋
"tran": "n. 公司,廠商(firm 的復(fù)數(shù)); v. 變得堅(jiān)實(shí)(firm 的第三人稱單數(shù))",
// 當(dāng)前詞學(xué)段,可能有多個(gè),學(xué)段信息等同入?yún)tLevel列表
"stuLevel": [
2
]
}
]
]
}
],
"sentFeedback": "",
"sentStartPos": 121,
"correctedSent": "For one thing, as they are the backbones of their companies, they have plenty of things to do at work.",
"isContainGrammarError": false,
"isContainTypoError": false,
"isValidLangSent": true
},
// 省略的中間的句子反饋信息
// 第8句話,僅有語(yǔ)法錯(cuò)誤信息
{
"rawSent": "And taking too much sleeping pills is bad for their health.",
"paraId": 0,
"sentId": 7,
// 所有的錯(cuò)誤信息
"errorPosInfos": [
{
// 錯(cuò)誤唯一標(biāo)識(shí)id
"id": 1667303701251,
// 類似下面的isValidSent,判斷是否為合法片段(該片段如果語(yǔ)言檢測(cè)結(jié)果與期望不一致,則認(rèn)為不合法)
"isValidLangChunk": true,
// 發(fā)生錯(cuò)誤的內(nèi)容
"orgChunk": "much",
// 業(yè)務(wù)錯(cuò)誤一級(jí)信息
"errorTypeTitle": "不同類代詞混淆",
// orgChunk相對(duì)rawSent 起始位置的偏移量
"startPos": 15,
// 錯(cuò)誤塊修正后的具體內(nèi)容
"correctChunk": "many",
// orgChunk相對(duì)rawSent 結(jié)束位置的偏移量
"endPos": 19,
// 錯(cuò)誤的副標(biāo)題信息
"cardSubtitle": "修改代詞",
// 錯(cuò)誤基本信息
"errBaseInfo": "代詞類型混淆會(huì)使指代對(duì)象有誤,建議將【much】修改為【many】",
// 業(yè)務(wù)劃定的錯(cuò)誤大類信息
"errToBBasicType": "句法",
// 錯(cuò)誤原因的詳細(xì)解釋(比reason更進(jìn)一步)
"detailReason": "代詞類型混淆會(huì)使指代對(duì)象有誤",
// 知識(shí)點(diǎn)或講解
"knowledgeExp": "代詞代替名詞、名詞性短語(yǔ)等,在句子可以作主語(yǔ)、賓語(yǔ)等。作主語(yǔ)時(shí),代詞可以表示動(dòng)作的施動(dòng)者;作賓語(yǔ)時(shí),表明行為或動(dòng)作的承受者。由此可見(jiàn),不同類型代詞的使用方式有一定的差別。",
// 所有例句
"exampleCases": [
{
// 例句
"right": "Half of the money was mine.",
// 例句翻譯
"rightTranslate": "一半的錢是我的。",
// 原句
"error": "Half of the money was my."
},
{
"right": "They did the cooking by themselves.",
"rightTranslate": "他們自己做飯。",
"error": "They did the cooking by theirs."
}
]
}
],
"synInfo": null,
"sentFeedback": "不同類代詞混淆,建議將〖much〗修改為【many】",
"sentStartPos": 661,
"correctedSent": "And taking too many sleeping pills is bad for their health.",
"isContainGrammarError": true,
"isContainTypoError": false,
"isValidLangSent": true
},
// 省略末尾句子反饋信息
]
},
// 單詞數(shù)
"wordNum": 204,
// 文章總分
"fullScore": 100,
// 請(qǐng)求學(xué)段英文名稱
"stLevel": "DEFAULT",
// 請(qǐng)求學(xué)段學(xué)段code
"stLevelCode": 0,
// 請(qǐng)求標(biāo)題
"title": "web",
// 請(qǐng)求寫(xiě)作模式
"writeModel": 1,
// 請(qǐng)求文體類型
"writeType": 1
}
}
高級(jí)版advanced
例:
{
"RequestId": "9cd0e024-5927-4c43-8fbf-0d36462cb4ca",
"errorCode": "0",
"Result": {
// 請(qǐng)求原文
"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.",
// 文章句子數(shù)
"sentNum": 5,
// 每個(gè)請(qǐng)求獨(dú)一無(wú)二的字符串標(biāo)識(shí)
"uniqueKey": "3b9e61e0-d6c1-4194-8cf6-2c4c9ae209c2",
// 文章最終評(píng)價(jià)
"essayAdvice": "",
// 文章最終得分
"totalScore": 0,
// 文章最終簡(jiǎn)短評(píng)價(jià)
"totalEvaluation": "Excellent!",
// 語(yǔ)言信息
"essayLangName": "English",
// 是AllFeatureScore中score整合結(jié)果
"majorScore": {
// 語(yǔ)法得分:包括拼寫(xiě)、語(yǔ)法、句子復(fù)雜度得分等
"grammarScore": 89.8,
// 語(yǔ)法評(píng)價(jià)
"grammarAdvice": "存在少量語(yǔ)法錯(cuò)誤,建議認(rèn)真檢查",
// 內(nèi)容(主題相關(guān)性)得分,如果沒(méi)有參考范文,該部分得分會(huì)從語(yǔ)法和復(fù)雜度上考慮
"topicScore": 66.2,
// 詞匯得分:包括詞數(shù)、豐富度、高級(jí)詞匯等得分
"wordScore": 89,
// 詞匯評(píng)價(jià)
"wordAdvice": "單詞拼寫(xiě)基本正確,單詞拼寫(xiě)基礎(chǔ)扎實(shí);詞匯量較為豐富,能使用一定數(shù)量的高級(jí)詞匯",
// 邏輯得分:包括段落和連接詞得分
"structureScore": 88.3,
// 邏輯評(píng)價(jià)
"structureAdvice": "邏輯性不錯(cuò),上下文關(guān)系銜接較為緊密"
},
// 段落數(shù)
"paraNum": 1,
// 文章批改結(jié)果
"essayFeedback": {
// 句子批改結(jié)果,所有的句子都僅有語(yǔ)法錯(cuò)誤,語(yǔ)法錯(cuò)誤詳細(xì)說(shuō)明看下方:語(yǔ)法錯(cuò)誤類型詳細(xì)說(shuō)明
"sentsFeedback": [
// 第1句話,包含單節(jié)點(diǎn)-點(diǎn)擊多項(xiàng)替換錯(cuò)誤、單節(jié)點(diǎn)-展示類型
{
// 原句
"rawSent": "Actually, it is sort of a fish berry jam.",
// 段落id,從0有序編號(hào)
"paraId": 0,
// 句子id,從0有序編號(hào)
"sentId": 0,
// 本句話中所有的語(yǔ)法錯(cuò)誤,包括基礎(chǔ)和高級(jí)錯(cuò)誤
"errorPosInfos": [
// 這是一個(gè)單節(jié)點(diǎn)-點(diǎn)擊多項(xiàng)替換錯(cuò)誤
{
// 推薦標(biāo)識(shí)id
"id": 1668590140818,
// 類似下面的isValidSent,判斷是否為合法片段(該片段如果語(yǔ)言檢測(cè)結(jié)果與期望不一致,則認(rèn)為不合法)
"isValidLangChunk": true,
// 發(fā)生錯(cuò)誤的內(nèi)容
"orgChunk": "Actually",
// 業(yè)務(wù)錯(cuò)誤一級(jí)信息
"errorTypeTitle": "詞匯頻繁使用",
// orgChunk相對(duì)rawSent 起始位置的偏移量
"startPos": 0,
// 錯(cuò)誤塊修正后的具體內(nèi)容
"correctChunk": "Actually",
// orgChunk相對(duì)rawSent 結(jié)束位置的偏移量
"endPos": 8,
// 錯(cuò)誤的副標(biāo)題信息
"cardSubtitle": "替換新單詞",
// 錯(cuò)誤基本信息
"errBaseInfo": "詞匯使用頻繁,建議替換新單詞",
// 業(yè)務(wù)劃定的錯(cuò)誤大類信息
"errToBBasicType": "",
// 錯(cuò)誤原因的詳細(xì)解釋(比reason更進(jìn)一步)
"detailReason": "詞匯使用頻繁",
// 所有例句
"exampleCases": [],
// 節(jié)點(diǎn)類型 1-單節(jié)點(diǎn),2-多節(jié)點(diǎn)
"nodeType": 1,
// 結(jié)構(gòu)類型 1-提示類,2-點(diǎn)擊單項(xiàng)替換,3-點(diǎn)擊多項(xiàng)替換,4-點(diǎn)擊選擇替換類
"structType": 3,
// 展示類型,1-基礎(chǔ)卡片與1.0一致,2-高級(jí)卡片
"showType": 2,
// 當(dāng)nodeType=1,structType=3時(shí),表示多項(xiàng)值
"target": [
"Really",
"Indeed"
],
// 是否vip卡片
"vip": true
},
// 這是一個(gè)單節(jié)點(diǎn)-提示類型錯(cuò)誤
{
"id": 1668590140820,
"isValidLangChunk": true,
"orgChunk": "sort of",
"errorTypeTitle": "不必要的修飾詞",
"startPos": 16,
"correctChunk": "sort of",
"endPos": 23,
"cardSubtitle": "刪除修飾詞",
"errBaseInfo": "學(xué)術(shù)用詞具體、簡(jiǎn)潔,口語(yǔ)化的一些補(bǔ)白詞不夠正式,表意模糊,建議刪除[rValidChunk]",
"errToBBasicType": "",
"detailReason": "學(xué)術(shù)用詞具體、簡(jiǎn)潔,口語(yǔ)化的一些補(bǔ)白詞不夠正式,表意模糊",
"knowledgeExp": "學(xué)術(shù)寫(xiě)作要求用詞<b>明確、簡(jiǎn)潔</b>,類似kind of的補(bǔ)白詞模糊性較強(qiáng),過(guò)于口語(yǔ)化,建議刪除。",
// 所有例句
"exampleCases": [
{
// 原句
"error": "An oil does not blend with water",
// 例句翻譯
"rightTranslate": "油不溶于水。",
// 例句
"right": "Oil does not blend with water."
}
],
"nodeType": 1,
"showType": 2,
"structType": 2,
"target": [],
"vip": true
}
],
// 錯(cuò)誤原因反饋,基于errorPosInfos中所有reason字段拼接而成
"sentFeedback": "詞匯頻繁使用,建議替換新單詞;不必要的修飾詞,建議刪除〖sort of〗",
// 該句子在全文中相對(duì)于文章 初始位置的偏移量
"sentStartPos": 0,
// 正確的句子
"correctedSent": "Actually, it is sort of a fish berry jam.",
// 返回是否含有語(yǔ)法錯(cuò)誤
"isContainGrammarError": false,
// 返回是否含有typo錯(cuò)誤
"isContainTypoError": false,
// 是否為合法句子(合法與否取決于語(yǔ)言檢測(cè)對(duì)該句的語(yǔ)言信息識(shí)別結(jié)果與期望結(jié)果是否一致)
"isValidLangSent": true,
},
// 省略的中間的句子反饋信息
// 第3句話,包含多節(jié)點(diǎn)選擇替換錯(cuò)誤
{
"rawSent": "We do the essential Python on 22nd September 2019.",
"paraId": 0,
"sentId": 2,
"errorPosInfos": [
// 這是一個(gè)多節(jié)點(diǎn)選擇替換錯(cuò)誤的其中一個(gè)節(jié)點(diǎn)
{
"id": 1668590140825,
"isValidLangChunk": true,
"orgChunk": "22nd September",
"errorTypeTitle": "日期表達(dá)不一致",
"startPos": 30,
"correctChunk": "{\"DthMonth\":\"22nd September\",\"TheDthofMonth\":\"the 22nd of September\",\"MonthDth\":\"September 22nd\"}",
"endPos": 44,
"cardSubtitle": "使用一致的日期表達(dá)",
"errBaseInfo": "上下文日期表達(dá)不一致,建議使用一致的日期表達(dá)",
"errToBBasicType": "",
"detailReason": "上下文日期表達(dá)不一致",
"knowledgeExp": "<b>日期</b>有幾種不同表達(dá)方式。January 20,January 20th,Jan. 20,以及20 January都是正確的。一篇文章通常<b>保持日期表達(dá)一致</b>。",
"exampleCases": [
],
// 多節(jié)點(diǎn)的parentId一致
"parentId": "1668590140767",
"nodeType": 2,
// 只有nodeType=2,structType=4,且是日期錯(cuò)誤才會(huì)出現(xiàn)
// 原片段
"orgDateType": "Dth Month",
"showType": 2,
"structType": 4,
"vip": true,
// 只有nodeType=2,structType=4,才會(huì)存在
"statInfo": [
{
// 該類型出現(xiàn)的數(shù)量
"count": 1,
// 示例,日期類型才會(huì)存在
"demo": "5th Dec",
// 類型
"item": "Dth Month"
},
{
"count": 1,
"demo": "The 5th of Dec",
"item": "The Dth of Month"
}
],
}
],
"sentFeedback": "大小寫(xiě)不統(tǒng)一,建議修改大小寫(xiě);日期表達(dá)不一致,建議使用一致的日期表達(dá)",
"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句話,包含多節(jié)點(diǎn)選擇替換錯(cuò)誤
{
"rawSent": "We do an important python on the 22nd of September 2019.",
"paraId": 0,
"sentId": 3,
"errorPosInfos": [
// 這是一個(gè)多節(jié)點(diǎn)選擇替換錯(cuò)誤的其中一個(gè)節(jié)點(diǎn),與第3句話的錯(cuò)誤有同樣的父parentId
{
"id": 1668590140828,
"isValidLangChunk": true,
"orgChunk": "the 22nd of September",
"orgDateType": "The Dth of Month",
"errorTypeTitle": "日期表達(dá)不一致",
"startPos": 29,
"correctChunk": "{\"DthMonth\":\"22nd September\",\"TheDthofMonth\":\"the 22nd of September\",\"MonthDth\":\"September 22nd\"}",
"endPos": 50,
"cardSubtitle": "使用一致的日期表達(dá)",
"errBaseInfo": "上下文日期表達(dá)不一致,建議使用一致的日期表達(dá)",
"errToBBasicType": "",
"detailReason": "上下文日期表達(dá)不一致",
"knowledgeExp": "<b>日期</b>有幾種不同表達(dá)方式。January 20,January 20th,Jan. 20,以及20 January都是正確的。一篇文章通常<b>保持日期表達(dá)一致</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,
"vip": true
}
],
"sentFeedback": "詞匯頻繁使用,建議替換新單詞;大小寫(xiě)不統(tǒng)一,建議修改大小寫(xiě);日期表達(dá)不一致,建議使用一致的日期表達(dá)",
"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句話,包含單節(jié)點(diǎn)點(diǎn)擊單項(xiàng)替換錯(cuò)誤
{
"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": "拼寫(xiě)不統(tǒng)一",
"startPos": 8,
"correctChunk": "five",
"endPos": 9,
"cardSubtitle": "拼寫(xiě)單詞",
"errBaseInfo": "阿拉伯?dāng)?shù)字應(yīng)該使用英文拼寫(xiě),建議將[orgChunk]修改為[correctChunk]",
"errToBBasicType": "",
"detailReason": "阿拉伯?dāng)?shù)字應(yīng)該使用英文拼寫(xiě)",
"knowledgeExp": "一般來(lái)說(shuō),<b>0到9的數(shù)字</b>都應(yīng)該<b>拼寫(xiě)</b>出來(lái)。如果想要表達(dá)日期、地址、金錢、分?jǐn)?shù)、百分比、分?jǐn)?shù)和小數(shù),可以直接使用數(shù)字。",
"exampleCases": [],
"nodeType": 1,
"showType": 2,
"structType": 2,
"vip": true
}
],
"sentFeedback": "拼寫(xiě)不統(tǒng)一,建議將〖5〗修改為【five】;詞匯頻繁使用,建議替換新單詞",
"sentStartPos": 213,
"correctedSent": "We have five apples in the important things 5 on Sep 2019.",
"isContainGrammarError": true,
"isContainTypoError": false,
"isValidLangSent": true
}
]
},
// 單詞數(shù)
"wordNum": 0,
// 文章總分
"fullScore": 100,
// 請(qǐng)求學(xué)段英文名稱
"stLevel": "TASK1",
// 請(qǐng)求學(xué)段code
"stLevelCode": 9,
// 請(qǐng)求標(biāo)題
"title": "yapi-test-1",
// 請(qǐng)求寫(xiě)作模式
"writeModel": 1,
// 請(qǐng)求文體類型
"writeType": 1,
// 請(qǐng)求細(xì)分學(xué)段code
"articleFormCode": 90102,
// 寫(xiě)作報(bào)告,可看下方
"essayReport": {}
}
}
寫(xiě)作報(bào)告essayReport:
{
"essayReport": {
// 平均句長(zhǎng)
"avgSentLen": 17.1,
// 平均句長(zhǎng)建議
"avgSentLenAdvice": "文章平均句長(zhǎng)為17.1,達(dá)到四級(jí)優(yōu)秀作文平均句長(zhǎng)。",
// 平均詞長(zhǎng)
"avgWordLen": 4.8,
// 平均詞長(zhǎng)建議
"avgWordLenAdvice": "平均詞長(zhǎng)代表了文章單詞的平均長(zhǎng)度。\n文章平均詞長(zhǎng)為4.8,達(dá)到四級(jí)優(yōu)秀作文平均詞長(zhǎng)。",
// 字符數(shù)
"charNum": 1013,
// 文章連接詞建議
"conjAdvice": {
// 需要將占位符替換的值列表
"fillers": [
6,
[
"并列",
"因果",
"順序"
]
],
// 建議,包括占位符字段
"original": "文章行文連貫,銜接手段運(yùn)用自如,段落間邏輯緊密層次分明,實(shí)為佳作!\n文中共使用了%s種邏輯連接詞,使用較多的有表示%s關(guān)系的邏輯連接詞。合理運(yùn)用邏輯連接詞可增強(qiáng)文章的連貫性與邏輯性,建議適當(dāng)積累一些邏輯連接詞。",
// 占位符
"placeholder": "%s"
},
// 邏輯連接詞,按比例從降序排序
"conjTypeInfos": [
{
// 數(shù)量
"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": "遞進(jìn)",
"percent": 0.07
},
{
"count": 1,
"name": "其他",
"percent": 0.07
}
],
// 邏輯連接詞數(shù)量
"conjWordNum": 7,
// 文章最終評(píng)價(jià)
"essayAdvice": "作文整體水平有待提高",
// 對(duì)應(yīng)級(jí)別滿分
"fullScore": 100,
// 語(yǔ)法錯(cuò)誤建議
"grammarErrorAdvice": {
// 建議
"advice": "建議復(fù)習(xí)相關(guān)語(yǔ)法知識(shí)。",
// 所有的語(yǔ)法錯(cuò)誤,按比例降序排序
"errors": [
{
// 出現(xiàn)次數(shù)
"count": 12,
// 錯(cuò)誤類型
"name": "詞匯拼寫(xiě)錯(cuò)誤",
// 出現(xiàn)比例,二位小數(shù)
"percent": 0.33
},
{
"count": 7,
"name": "詞匯使用錯(cuò)誤",
"percent": 0.2
},
{
"count": 4,
"name": "固定搭配介詞錯(cuò)誤",
"percent": 0.11
},
{
"count": 3,
"name": "名詞單復(fù)數(shù)錯(cuò)誤",
"percent": 0.09
},
{
"count": 2,
"name": "限定詞缺失",
"percent": 0.06
},
{
"count": 7,
"name": "其他",
"percent": 0.21
}
],
// 評(píng)價(jià)
"evaluation": "整體語(yǔ)法錯(cuò)誤較多,高頻語(yǔ)法錯(cuò)誤有",
// 高頻的語(yǔ)法錯(cuò)誤
"highFreqErrors": [
"詞匯拼寫(xiě)錯(cuò)誤",
"詞匯使用錯(cuò)誤"
]
},
// 真正的語(yǔ)法錯(cuò)誤數(shù)量
"grammarErrorNum": 23,
// 錯(cuò)誤的句子比率
"grammarErrorSentRatio": 0.8,
// 高頻語(yǔ)法錯(cuò)誤
"highFreqErrors": [
{
// 出現(xiàn)次數(shù)
"count": 12,
// 錯(cuò)誤類型
"name": "詞匯拼寫(xiě)錯(cuò)誤"
},
{
// 出現(xiàn)次數(shù)
"count": 7,
// 錯(cuò)誤類型
"name": "詞匯使用錯(cuò)誤"
}
],
// 詞匯水平分布信息,占比保留3位小數(shù)
"lexicalDistribution": {
// 詞匯水平分布建議
"advice": "您的文章與<span>優(yōu)秀四級(jí)</span>作文平均詞匯分布相比:使用的詞匯水平有限,詞匯分布合理,滿足考試的需求,建議繼續(xù)通過(guò)寫(xiě)作練習(xí)詞匯和表達(dá)哦!",
//小學(xué)詞匯數(shù)量
"primaryWordNum": 0,
//小學(xué)詞匯數(shù)量占比
"primaryWordNumPercent": 0.000,
//初中詞匯數(shù)量
"juniorWordNum": 0,
//初中詞匯數(shù)量占比
"juniorWordNumPercent": 0.000,
//高中詞匯數(shù)量
"seniorWordNum": 0,
//高中詞匯數(shù)量占比
"seniorWordNumPercent": 0.000,
//四級(jí)詞匯數(shù)量
"cet4WordNum": 0,
//四級(jí)詞匯數(shù)量占比
"cet4WordNumPercent": 0.000,
//六級(jí)詞匯數(shù)量
"cet6WordNum": 0,
//六級(jí)詞匯數(shù)量占比
"cet6WordNumPercent": 0.000,
//托福詞匯數(shù)量
"toeflAndIeltsWordNum": 0,
//托福詞匯數(shù)量占比
"toeflAndIeltsWordNumPercent": 0.000
},
// 主要得分和建議,分?jǐn)?shù)一位小數(shù)
"majorScore": {
//語(yǔ)法得分:包括拼寫(xiě)、語(yǔ)法、句子復(fù)雜度得分等
"grammarScore": 0.0,
//語(yǔ)法評(píng)價(jià)
"grammarAdvice": "",
//內(nèi)容(主題相關(guān)性)得分,如果沒(méi)有參考范文,該部分得分會(huì)從語(yǔ)法和復(fù)雜度上考慮
"topicScore": 0.0,
//內(nèi)容評(píng)價(jià),目前均為null
"topicAdvice": "",
//詞匯得分:包括詞數(shù)、豐富度、高級(jí)詞匯等得分
"wordScore": 0.0,
//詞匯評(píng)價(jià)
"wordAdvice": "",
//邏輯得分:包括段落和連接詞得分
"structureScore": 0.0,
//邏輯評(píng)價(jià)
"structureAdvice": "",
/**
* 重點(diǎn)項(xiàng)
* 0 :語(yǔ)法分項(xiàng)
* 1 :單詞分項(xiàng)
* 2 :結(jié)構(gòu)分項(xiàng)
*/
"emphasis": 0
},
// 批改中包含在語(yǔ)法錯(cuò)誤中,但在寫(xiě)作報(bào)告中并非語(yǔ)法錯(cuò)誤的數(shù)量(標(biāo)點(diǎn)、拼寫(xiě)、空格)
"notTrueGrammarErrorNum": 15,
// 段落數(shù)
"paraNum": 1,
// 原文長(zhǎng)度
"rawLength": 1024,
// 可讀性得分對(duì)應(yīng)等級(jí)
"readGrade": 5,
// 可讀性得分
"readability": 71,
// 可讀性評(píng)價(jià)
"readabilityEvaluation": "文章適合具有專家英語(yǔ)水平的人群閱讀",
// 優(yōu)秀分界線,小數(shù)點(diǎn)數(shù)值類型保留1-3位小數(shù)
"scoreBorders": {
//水平編號(hào)
"stLevel": "4",
//水平名稱
"name": "四級(jí)",
//優(yōu)秀作文平均詞長(zhǎng)上邊界
"maxAvgWordsLen": 0.0,
//優(yōu)秀作文平均詞長(zhǎng)下邊界
"minAvgWordsLen": 0.0,
//優(yōu)秀作文平均句長(zhǎng)上邊界
"maxAvgSentsLen": 0.0,
//優(yōu)秀作文平均句長(zhǎng)下邊界
"minAvgSentsLen": 0.0,
//優(yōu)秀作文句子豐富度上邊界
"maxStdSentsLen": 0.0,
//優(yōu)秀作文句子豐富度下邊界
"minStdSentsLen": 0.0,
//優(yōu)秀作文小學(xué)詞匯占比
"maxPrimary": 0.0,
//優(yōu)秀作文初中詞匯占比
"maxJunior": 0.0,
//優(yōu)秀作文高中詞匯占比
"maxSenior": 0.0,
//優(yōu)秀作文四級(jí)詞匯占比
"maxCET4": 0.0,
//優(yōu)秀作文六級(jí)詞匯占比
"maxCET6": 0.0,
//優(yōu)秀作文托福雅思詞匯占比
"maxToeflAndIelts": 0.0
},
// 句子成分
"sentComplexInfo": {
// 復(fù)雜句數(shù)量
"complexSentNum": 6,
// 復(fù)雜句百分比
"complexSentPercent": 0.5,
// 句子評(píng)價(jià)建議
"sentenceStructureAdvice": "簡(jiǎn)單句與復(fù)雜句均能綜合使用,句子結(jié)構(gòu)較為合理。",
// 簡(jiǎn)單句數(shù)量
"simpleSentNum": 6,
// 簡(jiǎn)單句百分比
"simpleSentPercent": 0.5
},
// 句子數(shù)
"sentNum": 12,
// 句長(zhǎng)豐富度
"stdSentLen": 7.9,
// 句長(zhǎng)豐富度建議,計(jì)算結(jié)果
"stdSentLenAdvice": "句長(zhǎng)豐富度會(huì)影響文章結(jié)構(gòu)分。\n文章句長(zhǎng)豐富度為7.9,達(dá)到四級(jí)優(yōu)秀作文句長(zhǎng)豐富度,文章讀起來(lái)比較生動(dòng)。",
// 總得分
"totalScore": 57,
// 單子數(shù)
"wordNum": 178
},
}
常用語(yǔ)言 Demo
Java 示例
英文文本批改 Java demo
Python 示例~
英文文本批改 Python3 demo
C# 示例
英文文本批改 c# demo
PHP 示例
英文文本批改 php demo
go 示例
英文文本批改 go demo