API文檔
IOS_SDK文檔
SDK隱私政策
中文作文批改（文本輸入）
中文作文批改（文本輸入） API 簡介
說明
Hi，您好，歡迎使用有道智云中文作文批改（文本輸入）API 接口服務。
本文檔主要針對需要集成 HTTP API 的技術開發(fā)工程師，詳細描述中文作文批改（文本輸入）能力相關的技術內容。
如果您有與我們商務合作的需求，可以通過以下方式聯(lián)系我們：
商務郵箱： AIcloud_Business@corp.youdao.com
如果您對文檔內容有任何疑問，可以通過以下幾種方式聯(lián)系我們：
客服 QQ：1906538062
智云作文批改技術交流 QQ 1 群: 1092639188
聯(lián)系郵箱： zhiyun@corp.youdao.com
溫馨提示：
- 本文檔主要針對開發(fā)人員，接入測試前需要獲取應用 ID 和應用密鑰；如果您還沒有，請按照 新手指南 獲取。
- 平臺向每個賬戶贈送 50 元的體驗金，供用戶集成前測試所用，具體資費規(guī)則詳見 中文作文批改服務報價 。
接口說明
有道 AI 團隊自研的基于深度學習網絡技術的自動作文批改技術。覆蓋學生學習全周期，提供高參考價值的智能批改功能，用戶只需要輸入一篇作文，選擇對應的作文級別，智能批改服務即可一鍵給出文章得分、整體評價、拼寫錯誤反饋、語法錯誤反饋、主題相關度反饋、以及高級詞匯和推薦詞組等一系列結果，從而向用戶提供針對性的作文指導意見。
中文作文批改（文本輸入） API HTTPS 地址：
請求方式：POST
https://openapi.youdao.com/correct_writing_cn_text
協(xié)議須知
調用方在集成文本翻譯 API 時，請遵循以下規(guī)則。
| 規(guī)則 | 描述 |
|---|---|
| 傳輸方式 | HTTPS |
| 請求方式 | POST |
| 字符編碼 | 統(tǒng)一使用 UTF-8 編碼 |
| 請求格式 | 表單 |
| 響應格式 | JSON |
接口調用參數(shù)
調用 API 需要向接口發(fā)送以下字段來訪問服務。
| 字段名 | 含義 | 備注 | 必填 |
|---|---|---|---|
| appKey | 應用標識（應用 ID） | 控制臺創(chuàng)建應用獲取 | true |
| curtime | 當前UTC時間戳(秒) | 時間戳 | true |
| q | 正文文本 | 支持中文，長度<=1200 | true |
| salt | 隨機字符串 | 1658393284erw | true |
| sign | 簽名信息：sha256(appKey+input+salt+密鑰+curtime) | sha256(appKey+input+salt+密鑰) | true |
| signType | 簽名類型 | v3 | true |
| grade | 作文等級 | 對應k12等級（詳見注意） | false |
| title | 作文標題 | 長度<=30 | false |
| requirement | 題目要求 | 長度<=200 | false |
- 注意：grade 級別為 K12，參數(shù)從 g1、g2、...、g12，默認g1
服務配置
| 服務內容 | 說明 |
|---|---|
| 文本輸入 | 最大支持 1200字符 |
錯誤代碼列表
| 錯誤碼 | 含義 |
|---|---|
| 101 | 缺少必填的參數(shù)，首先確保必填參數(shù)齊全，然后，確認參數(shù)書寫是否正確。 |
| 102 | 不支持的語言類型 |
| 103 | 翻譯文本過長 |
| 104 | 不支持的 API 類型 |
| 105 | 不支持的簽名類型 |
| 106 | 不支持的響應類型 |
| 107 | 不支持的傳輸加密類型 |
| 108 | appKey 無效，注冊賬號， 登錄后臺創(chuàng)建應用和實例并完成綁定， 可獲得應用 ID 和密鑰等信息，其中應用 ID 就是 appKey（ 注意不是應用密鑰） |
| 109 | batchLog 格式不正確 |
| 110 | 無相關服務的有效實例，應用沒有綁定服務實例，可以新建服務實例，綁定服務實例。注：某些服務的翻譯結果發(fā)音需要 tts 實例，需要在控制臺創(chuàng)建語音合成實例綁定應用后方能使用。 |
| 111 | 開發(fā)者賬號異常 |
| 201 | 解密失敗，可能為 DES,BASE64,URLDecode 的錯誤 |
| 202 | 簽名檢驗失敗，如果確認應用 ID 和應用密鑰的正確性，仍返回 202，一般是編碼問題。請確保翻譯文本 q 為 UTF-8 編碼. |
| 203 | 訪問 IP 地址不在可訪問 IP 列表 |
| 205 | 請求的接口與應用的平臺類型不一致，確保接入方式（Android SDK、IOS SDK、API）與創(chuàng)建的應用平臺類型一致。 |
| 206 | 因為時間戳無效導致簽名校驗失敗 |
| 207 | 重放請求 |
| 301 | 辭典查詢失敗 |
| 302 | 小語種查詢失敗 |
| 303 | 服務端的其它異常 |
| 401 | 賬戶已經欠費停 |
| 411 | 訪問頻率受限,請稍后訪問 |
| 412 | 大圖片請求過于頻繁，請稍后訪問 |
| 29001 | inputType 類型不對 |
| 29002 | needTypo 類型不對 |
| 29003 | Q 超過限制長度 |
| 29004 | grade 類型不對 |
| 29005 | 文件為空 |
| 29006 | 圖片過大 |
| 29007 | 作文批改的文本內容為空 |
| 29103 | 含不合時宜詞匯 |
| 29301 | 作文批改識別失敗 |
| 29302 | 作文批改請求失敗 |
返回結果參數(shù)
| 參數(shù)名稱 | 描述 |
|---|---|
| RequestId | 請求Id |
| errorCode | 錯誤碼 |
| Result | 返回結果（詳見result項） |
Result內容：
| 名稱 | 類型 | 描述 |
|---|---|---|
| orgContent | String | 原始的作文內容 |
| correctedContent | List of CorrectedSent | content 詳細的糾正信息（詳見CorrectedSent項） |
| scoreCollection | ScoreCollection | 所有的評分信息（詳見ScoreCollection項） |
| commentCollection | CommentCollection | 所有的評價信息（詳見commentCollection項） |
| detailedEvaluation | DetailedEvaluation | 從句子、詞語角度給出詳細的評價（詳見detailedEvaluation項） |
CorrectedSent內容：
| 名稱 | 類型 | 描述 |
|---|---|---|
| paraId | Integer | 段落ID |
| sentId | Integer | 句子ID |
| orgSent | String | 原始句子 |
| corSent | String | 修正后的句子 |
| orgSentStart | Integer | 原始句子的起始位置（相對于請求中的 content、包含了空格空行等） |
| errorInfos | List of ErrorInfo | 針對當前句子的錯誤信息（詳見ErrorInfo項） |
ErrorInfo內容：
| 名稱 | 類型 | 描述 |
|---|---|---|
| orgChunk | String | 原始片段 |
| corChunk | String | 正確片段 |
| orgChunkStart | Integer | 原始片段的起始位置（相對于 orgSent、包含了空格等） |
| errorType | String | 錯誤類型，可選項見ErrorType可選項 |
ErrorType可選項
| ErrorType可選項 | 名稱 | 解釋 |
|---|---|---|
| spell | 拼寫錯誤 | 拼寫錯誤包括了同音字錯誤等 |
| space | 空格錯誤 | 與空格相關的各種錯誤 |
| punct | 標點錯誤 | 與標點符號相關的各種錯誤 |
| grammar | 語法錯誤 | 上述錯誤之外的錯誤，會被劃分為語法錯誤 |
CommentCollection
| 名稱 | 類型 | 描述 |
|---|---|---|
| comment | String | 整體評價 |
detailedEvaluation
| 名稱 | 類型 | 描述 |
|---|---|---|
| sentenceEvaluation | List of SentenceEvaluation | 針對句子的評價，比如是不是好句子 |
| phraseEvalution | List of PhraseEvaluation | 針對詞語的評價，比如成語 |
SentenceEvaluation （位置信息是左閉右開的區(qū)間）
| 名稱 | 類型 | 描述 |
|---|---|---|
| type | String | 目前有可選項“good”，用來表明是好句子 |
| start | Integer | 句子的起始位置（相對于請求中的 content）(unicode) |
| end | Integer | 句子的結束位置（相對于請求中的 content）(unicode) |
PhraseEvaluation （位置信息是左閉右開的區(qū)間）
| 名稱 | 類型 | 描述 |
|---|---|---|
| type | String | 目前有可選項“idiom”，用來表明是成語 |
| start | Integer | 句子的起始位置（相對于請求中的 content）(unicode) |
| end | Integer | 句子的結束位置（相對于請求中的 content）(unicode) |
| explanation | String | 成語解釋，當 type==“idiom”的時候，這個字段有效 |
ScoreCollection內容：
| 名稱 | 類型 | 限制條件 | 描述 |
|---|---|---|---|
| score | Integer | 0<=score<=100 | 整體得分 |
| perspectiveScore | PerspectiveScore | 見下面的 PerspectiveScore | 從不同的角度，對作文進行打分 |
PerspectiveScore（詳見評分規(guī)則）
| 名稱 | 類型 | 限制條件 | 描述 |
|---|---|---|---|
| themeExplicit | Integer | 0<=分數(shù)<=5 | 主題明確，需要傳入requirement，title才是有效分數(shù) |
| satisfyRequirement | Integer | 0<=分數(shù)<=5 | 符合題意 ，需要傳入requirement才是有效分數(shù) |
| sentimentSincerity | Integer | 0<=分數(shù)<=5 | 感情真摯 |
| structureStrict | Integer | 0<=分數(shù)<=5 | 結構嚴謹 |
| essayFluence | Integer | 0<=分數(shù)<=5 | 語言流暢 |
| goodSent | Integer | 0<=分數(shù)<=5 | 好詞好句 |
評分規(guī)則
| 評價的方面 | 得分或者限制 | 對應的評語 |
|---|---|---|
| satisfyRequirement | 0 | |
| satisfyRequirement | 1 | 對題意的理解不夠充分，有偏題的嫌疑。 |
| satisfyRequirement | 2 | 能理解題目要求，文章基本符合題意。 |
| satisfyRequirement | 3 | 能較好地把握題目要求，文章符合題意。 |
| satisfyRequirement | 4 | 能正確理解題目要求，文章符合題意。 |
| satisfyRequirement | 5 | 能準確理解題目要求，文章切合題意。 |
| themeExplicit | 0 | 中心不夠明確，立意不夠清晰。 |
| themeExplicit | 1 | 中心不夠明確，立意不夠清晰。 |
| themeExplicit | 2 | 雖有中心主題，但表達不夠充分有力，文章略顯空洞。 |
| themeExplicit | 3 | 主題基本明確。 |
| themeExplicit | 4 | 主題較明確。 |
| themeExplicit | 5 | 主題明確，立意鮮明。 |
| goodSent | 0 | |
| goodSent | 1 | 用詞過于平淡，缺乏文采。 |
| goodSent | 2 | 偶爾使用好詞好句，語言平淡質樸。 |
| goodSent | 3 | 能夠適當運用好詞好句，語言生動活潑。 |
| goodSent | 4 | 遣詞造句優(yōu)美，文章富有文采。 |
| goodSent | 5 | 本文語言極其優(yōu)美，文章極富文學氣息。 |
| sentimentSincerity | 0 | 感受不深刻，缺乏感染力。 |
| sentimentSincerity | 1 | 情感缺乏深度。 |
| sentimentSincerity | 2 | 語言簡樸，感情平淡，情意不夠深切。 |
| sentimentSincerity | 3 | 感情真實，發(fā)自肺腑。 |
| sentimentSincerity | 4 | 情感飽滿，情真意切，能深深打動讀者。 |
| sentimentSincerity | 5 | 感情真摯動人，情感豐沛，極富感染力。 |
| structureStrict | 0 | 條理不清，結構混亂。 |
| structureStrict | 1 | 層次不清，結構較亂。 |
| structureStrict | 2 | 層次欠清楚，結構較合理。 |
| structureStrict | 3 | 層次較分明，結構完整。 |
| structureStrict | 4 | 層次清晰，結構完整。 |
| structureStrict | 5 | 層次清晰，結構嚴謹。 |
| essayFluence | 0 | 語句不通順，表述不清晰，令人費解。 |
| essayFluence | 1 | 語句欠通，缺乏連貫性。 |
| essayFluence | 2 | 語句基本通順，偶有不暢。 |
| essayFluence | 3 | 語句通順流暢。 |
| essayFluence | 4 | 語句流暢連貫，自然通達。 |
| essayFluence | 5 | 語言平滑曉暢，可讀性強。 |
| 比喻手法 | > 3 | 比喻生動形象貼切，本體與喻體形神相似，文章的趣味性與說服力都大大增強了。 |
| 排比手法 | > 2 | 運用排比的手法，既增強語勢，又給讀者留下了十分深刻的印象。 |
| 其他 | words < 20 or paragraphs < 2 | 您輸入的作文句子、段落數(shù)量較少。 |
- 當有額外的
比喻手法、排比手法出現(xiàn)的時候，會用此外，進行銜接 - 當符合
其他的情況的時候，會直接返回對應的評語
常用語言 Demo
請參考英文作文批改服務示例demo