共用方式為


Microsoft 認知動作

Azure 認知服務可讓使用者使用人工智慧加速決策,而不需要機器學習專業技能。

重要

Azure 將於 2024 年 2 月 29 日停用 Azure 認知服務文字分析 v2.xMicrosoft 認知文字分析動作使用此程式庫。 2024 年 2 月 29 日之後,桌面流程將不再支援這些動作,並且這些動作將無法運作。

桌面流程提供多種 Microsoft 認知動作,讓您可將此功能整合至您的桌面流程。 文字分析、電腦視覺和拼字檢查均為 Microsoft 認知動作可執行的工作。

所有的 Microsoft 認知動作都需要訂閱金鑰,以驗證一個服務或一組服務的訂閱。 在 Azure 入口網站中,可找到您已建立之每個資源的金鑰。

拼字檢查動作的螢幕截圖。

拼字檢查

叫用名為「Bing 拼字檢查」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
Text 文字值清單 要傳送的文字或文字清單
Mode 文字值 指定拼字檢查模式
Mkt 文字值 在校對模式下,僅支援語言代碼:en-us、es-es、pt-br。 在拼字模式下,支援所有的語言代碼
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題

分析影像

叫用名為「分析影像」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Server location 無法使用 美國西部、美國西部 2、美國東部、美國東部 2、美國中西部、美國中南部、西歐、北歐、東南亞、東亞、澳洲東部、巴西南部、加拿大中部、印度中部、英國南部、日本東部 美國西部 用於此 API 呼叫的伺服器位置
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
Provide image 無法使用 從檔案、從 GCS 從檔案 指定影像是由完整路徑還是 URL 位址來提供
Image file 檔案 要傳輸之影像檔的完整路徑 (資料夾和檔案名稱)
Image URL 文字值 影像的 URL 位址
Visual features 文字值 指示要傳回何種視覺特徵類型的文字值。 多個值應以逗號分隔。 例如:類別、標記、描述
Details 文字值 指示要傳回哪些特定網域相關詳細資料的文字值。 多個值應以逗號來分隔
Language 文字值 指示要傳回哪個語言的文字值。 服務會以指定的語言傳回辨識結果
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題

描述影像

叫用名為「描述影像」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Server location 無法使用 美國西部、美國西部 2、美國東部、美國東部 2、美國中西部、美國中南部、西歐、北歐、東南亞、東亞、澳洲東部、巴西南部、加拿大中部、印度中部、英國南部、日本東部 美國西部 用於此 API 呼叫的伺服器位置
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
Provide image 無法使用 從檔案、從 GCS 從檔案 指定影像是由完整路徑還是 URL 位址來提供
Image file 檔案 要傳輸之影像檔的完整路徑 (資料夾和檔案名稱)
Image URL 文字值 影像的 URL 位址
Max candidates 文字值 要傳回的侯選描述數目上限。 預設值是 1
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題

OCR

叫用名為「OCR」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Server location 無法使用 美國西部、美國西部 2、美國東部、美國東部 2、美國中西部、美國中南部、西歐、北歐、東南亞、東亞、澳洲東部、巴西南部、加拿大中部、印度中部、英國南部、日本東部 美國西部 用於此 API 呼叫的伺服器位置
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
Provide image 無法使用 從檔案、從 GCS 從檔案 指定影像是由完整路徑還是 URL 位址來提供
Image file 檔案 要傳輸之影像檔的完整路徑 (資料夾和檔案名稱)
Image URL 文字值 影像的 URL 位址
Language 文字值 要在影像中偵測之文字的 BCP-47 語言代碼
Detect orientation 文字值 指定是否要偵測影像中的文字方向
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題

標記影像

叫用名為「標記影像」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Server location 無法使用 美國西部、美國西部 2、美國東部、美國東部 2、美國中西部、美國中南部、西歐、北歐、東南亞、東亞、澳洲東部、巴西南部、加拿大中部、印度中部、英國南部、日本東部 美國西部 用於此 API 呼叫的伺服器位置
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
Provide image 無法使用 從檔案、從 GCS 從檔案 指定影像是由完整路徑還是 URL 位址來提供
Image file 檔案 要傳輸之影像檔的完整路徑 (資料夾和檔案名稱)
Image URL 文字值 影像的 URL 位址
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題

偵測語言

叫用名為「文字分析 - 偵測語言」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Server location 無法使用 美國西部、美國西部 2、美國東部、美國東部 2、美國中西部、美國中南部、西歐、北歐、東南亞、東亞、澳洲東部、巴西南部、加拿大中部、印度中部、英國南部、日本東部 美國西部 用於此 API 呼叫的伺服器位置
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
Text 文字值 要分析的文字
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題

關鍵片語

叫用名為「文字分析 - 關鍵片語」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Server location 無法使用 美國西部、美國西部 2、美國東部、美國東部 2、美國中西部、美國中南部、西歐、北歐、東南亞、東亞、澳洲東部、巴西南部、加拿大中部、印度中部、英國南部、日本東部 美國西部 用於此 API 呼叫的伺服器位置
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
Text 文字值清單 要分析的文字或文字清單
Language 文字值 文字的語言
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題

情緒

叫用名為「文字分析 - 情緒」的 Microsoft 認知服務。

輸入參數

引數 選用 接受 預設值 描述
Server location 無法使用 美國西部、美國西部 2、美國東部、美國東部 2、美國中西部、美國中南部、西歐、北歐、東南亞、東亞、澳洲東部、巴西南部、加拿大中部、印度中部、英國南部、日本東部 美國西部 用於此 API 呼叫的伺服器位置
Subscription key 文字值 要用來進行此 API 呼叫的訂閱金鑰
文字 文字值清單 文字
語言 文字值 文字語言的兩字母 ISO 639-1 表示法
Timeout 數值 30 專員與伺服器建立連線所應等待的時間 (以秒計),而此時間過後,連線即失敗

變數已產生

引數 類型​ 描述
JSONResponse 自訂物件 API 回應結果
StatusCode 數值 傳回的狀態碼

例外狀況

例外 描述
已超過要求逾時 指示執行要求時已超過逾時
無法叫用認知服務 指示嘗試叫用認知服務時發生問題