Smart correction (智慧改錯) 提供一組 Web API,用於偵測文章中的錯字。下列步驟將以命令列工具示範服務用法。

Step 1. 發起HTTP Request

POST http://developer.udndigital.com.tw/nlp/text:smartcorrection

Step 2. 建立要求主體(Request body)

The request body contains data with the following structure:
{
    "text": "高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人盡速前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、金芭黎、帝堡、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。",
    "format": "raw",
    "enable_cterm_whitelist": true,
    "sent_tokenize": true,
    "multiprocess": true,
    "additional_whitelist": [],
    "validate_with_mlm": true,
    "mode": "CSC_UNI"
}

Step 3. API 參數說明

欄位 參數說明
mode 功能選擇(CSC_NMT 為改錯、UNI_CSC 為改錯加統一用詞、CSC_Channel 為通道翻譯模型)
format 回傳的格式,可使用 html, raw, html_mark_edit, test,預設為 html
text 要偵測改錯的文本
enable_cterm_whitelist 使用中文專有名詞白名單。預設為true
sent_tokenize 對文本使用斷句,再對每個斷開後的句子做改正。預設為false
multiprocess 使用平行處理加速斷句後改錯(sent_tokenize 需為 true)。預設為false
additional_whitelist 將自訂的中文專有名詞加入白名單(enable_cterm_whitelist 需為 true)。預設為 empty list
validate_with_mlm 使用 Masked Language Model 進行改錯驗證。預設為false,建議設定為true

範例

以下透過五組Request以及Response說明各參數搭配之回傳結果。

Request 1

{ "text": "高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人盡速前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、金芭黎、帝堡、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。", "format": "html", "enable_cterm_whitelist": true, "sent_tokenize": true, "multiprocess": true, "additional_whitelist": [], "validate_with_mlm": true, "mode": "CSC_UNI" }

Response 1

說明:顯示改正過後的結果。
{ "text": "高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人<span style=\"color:Blue\">儘速</span>前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、<span style=\"color:Blue\">金巴黎</span>、<span style=\"color:Blue\">帝寶</span>、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。" }

Request 2

format: "raw"
{ "text": "高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人盡速前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、金芭黎、帝堡、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。", "format": "raw", "enable_cterm_whitelist": true, "sent_tokenize": true, "multiprocess": true, "additional_whitelist": [], "validate_with_mlm": true, "mode": "CSC_UNI" }

Response 2

說明:回傳被修改前、後的詞、修改類別(統一用詞、智慧改錯)以及位置。給前端做提示小卡時,使用本結構。
{ "text": [ [ 140, 142, "錯別字", "盡速", "儘速" ], [ 448, 451, "錯別字", "金芭黎", "金巴黎" ], [ 452, 454, "錯別字", "帝堡", "帝寶" ] ] }

Request 3

format: "html_mark_edit"
{ "text": "高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人盡速前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、金芭黎、帝堡、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。", "format": "html_mark_edit", "enable_cterm_whitelist": true, "sent_tokenize": true, "multiprocess": true, "additional_whitelist": [], "validate_with_mlm": true, "mode": "CSC_UNI" }

Response 3

說明:顯示本來的詞、被改成什麼詞,並用不同的顏色呈現。
{ "text": 高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人<span style=\"color:Red\">盡速</span><span style=\"color:Blue\">儘速</span>前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、<span style=\"color:Red\">金芭黎</span><span style=\"color:Blue\">金巴黎</span>、<span style=\"color:Red\">帝堡</span><span style=\"color:Blue\">帝寶</span>、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。 }

Request 4

format: "test"
{ "text": "高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人盡速前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、金芭黎、帝堡、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。", "format": "test", "enable_cterm_whitelist": true, "sent_tokenize": true, "multiprocess": true, "additional_whitelist": [], "validate_with_mlm": true, "mode": "CSC_UNI" }

Response 4

說明:直接顯示改正結果。
{ "text": "高雄市娛樂場所後確診人數大爆發,在昨天增加59例後,今天又續增58例本土確診,主要來自酒店衍生出來的傳播鏈。高雄市府指出,今天新增的個案主要是延續昨天的娛樂場所傳播鏈,且擴大至大帝國舞廳,另有小吃部、養生會館等地也有個案傳出,呼籲3月29日以後曾涉足金芭黎等13處特定娛樂場所的人儘速前往社區篩檢站採檢。\n\n薩克斯風女樂手衍生出雅閣、金芭黎與帝堡三大娛樂場所傳播鏈。高雄市長陳其邁指出,今天高雄新增58例,主要是持續昨天案23388來自台中婚宴造成案25606的群聚案,今天持續擴大至大帝國9例及帝堡累計至10例,原因是主要足跡停留處於密閉空間,所以病例數相對多,其他娛樂場所也有些零星一例,另外有些與原傳播鏈有關。\n\n陳其邁說,今天其他娛樂場所(酒店、小吃部、養生會館)10例,居陰轉陽2例,疫調中12例,25005台中群聚案增1例,桃園確診者1例,案25698增1例,另疑似境外案衍生(小港)1例,花東旅遊史2例。\n\n簡任技正潘炤穎指出,今天新增58例,最多是娛樂場所衍生出來的傳播鏈,雅閣、金巴黎、帝寶、大帝國等4家娛樂場所到今天為止單日新增28例,另外擴及九個娛樂場所,累計為10例。\n\n潘說,綜合以上狀況,目前相關從業人員到檢率只有六成左右,提醒大家盡速採檢,因為在密閉空間內不外乎餐飲飲食、唱歌與聊天,容易近距離接觸造成擴散,在此呼籲,3月29日以後有去13家娛樂場所消費停留或與從業人員接觸者,快去篩檢。" }

Request 5

將自訂的中文專有名詞加入白名單,避免被改正 (可搭配NER系統,將系統辨識出的人名、地名等設為參數)
{ "text": "這次選舉由共和黨籍參議原普度對上民主黨的挑戰者奧薩夫;共和黨參議員羅夫勒對上民主黨沃諾克。", "format": "raw", "enable_cterm_whitelist": true, "sent_tokenize": true, "multiprocess": true, "additional_whitelist": ["普度", "奧薩夫", "羅夫勒", "沃諾克"], "validate_with_mlm": true, "mode": "CSC_UNI" }

Response 5

{ "text": [ [ 9, 12, "錯別字", "參議原", "參議員" ] ] }