API文檔
IOS_SDK文檔
SDK隱私政策
Hi,您好,歡迎使用有道智云中文作文指導(dǎo)(圖像識別)API 接口服務(wù)。
本文檔主要針對需要集成 HTTP API 的技術(shù)開發(fā)工程師,詳細描述中文作文指導(dǎo)(圖像識別)能力相關(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
溫馨提示:
有道 AI 團隊自研的基于深度學(xué)習(xí)網(wǎng)絡(luò)技術(shù)的自動作文指導(dǎo)技術(shù)。覆蓋學(xué)生學(xué)習(xí)全周期,提供高參考價值的智能批改功能,用戶只需要輸入中文作文題目要求,智能指導(dǎo)服務(wù)即可一鍵給出針對題目從多個角度的分析結(jié)果,從而向用戶提供相對全面的作文指導(dǎo)意見。
中文作文指導(dǎo)(圖像識別) API HTTPS 地址:
請求方式:POST
> https://openapi.youdao.com/correct_writing_cn_guide_image
調(diào)用方在集成文本翻譯 API 時,請遵循以下規(guī)則。
規(guī)則 | 描述 |
---|---|
傳輸方式 | HTTPS |
請求方式 | POST |
字符編碼 | 統(tǒng)一使用 UTF-8 編碼 |
請求格式 | 表單 |
響應(yīng)格式 | JSON |
調(diào)用 API 需要向接口發(fā)送以下字段來訪問服務(wù)。
字段名 | 含義 | 備注 | 必填 |
---|---|---|---|
appKey | 應(yīng)用標識(應(yīng)用 ID) | 控制臺創(chuàng)建應(yīng)用獲取 | true |
curtime | 當(dāng)前UTC時間戳(秒) | 時間戳 | true |
salt | 隨機字符串 | 1658393284erw | true |
sign | 簽名信息:sha256(appKey+input+salt+密鑰) | sha256(appKey+input+salt+密鑰) | true |
signType | 簽名類型 | v3 | true |
requirement | 題目要求(圖片的base64編碼) | 包含字符數(shù)長度限制[4 - 300] | true |
服務(wù)內(nèi)容 | 說明 |
---|---|
圖片識別 | 支持 jpg/png 格式,base64 編碼后進行 urlencode,要求 base64 編碼后大小不超過 5M,最短邊至少 15px,最長邊最大 4096px |
錯誤碼 | 含義 |
---|---|
101 | 缺少必填的參數(shù),首先確保必填參數(shù)齊全,然后,確認參數(shù)書寫是否正確。 |
102 | 不支持的語言類型 |
103 | 翻譯文本過長 |
104 | 不支持的 API 類型 |
105 | 不支持的簽名類型 |
106 | 不支持的響應(yīng)類型 |
107 | 不支持的傳輸加密類型 |
108 | appKey 無效,注冊賬號, 登錄后臺創(chuàng)建應(yīng)用和實例并完成綁定, 可獲得應(yīng)用 ID 和密鑰等信息,其中應(yīng)用 ID 就是 appKey( 注意不是應(yīng)用密鑰) |
109 | batchLog 格式不正確 |
110 | 無相關(guān)服務(wù)的有效實例,應(yīng)用沒有綁定服務(wù)實例,可以新建服務(wù)實例,綁定服務(wù)實例。注:某些服務(wù)的翻譯結(jié)果發(fā)音需要 tts 實例,需要在控制臺創(chuàng)建語音合成實例綁定應(yīng)用后方能使用。 |
111 | 開發(fā)者賬號異常 |
201 | 解密失敗,可能為 DES,BASE64,URLDecode 的錯誤 |
202 | 簽名檢驗失敗,如果確認應(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ù)端的其它異常 |
401 | 賬戶已經(jīng)欠費停 |
411 | 訪問頻率受限,請稍后訪問 |
412 | 大圖片請求過于頻繁,請稍后訪問 |
29001 | inputType 類型不對 |
29002 | needTypo 類型不對 |
29003 | Q 超過限制長度 |
29004 | grade 類型不對 |
29005 | 文件為空 |
29006 | 圖片過大 |
29007 | 作文批改的文本內(nèi)容為空 |
29100 | 作文指導(dǎo)底層異常 |
29101 | 作文指導(dǎo) requirement 長度超出限制 |
29102 | 作文指導(dǎo) requirement 語種不是中文 |
29103 | 含不合時宜詞匯 |
29301 | 作文批改識別失敗 |
29302 | 作文批改請求失敗 |
參數(shù)名稱 | 描述 |
---|---|
RequestId | 請求Id |
errorCode | 錯誤碼 |
msg | 錯誤信息 |
data | 指導(dǎo)結(jié)果(詳見data項) |
名稱 | 類型 | 描述 |
---|---|---|
failedTypes | List of Integer | 沒有結(jié)果的指導(dǎo)項 |
guidance | Guidance | 指導(dǎo)意見(詳見guidance項) |
名稱 | 類型 | 描述 |
---|---|---|
analysis | Integer | 題目解析 |
corePoint | Integer | 核心觀點 |
material | String | 素材參考 |
paraAlloc | String | 段落分配 |
取值 | 取值說明 |
---|---|
1 | 題?解析 |
2 | 素材參考 |
3 | 核?觀點 |
4 | 段落分配 |