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