本文介紹了如何使用Alibaba Content Security Service服務提供的內容檢測API SDK。
SDK使用說明
在使用SDK前,需瞭解各個介面的具體功能。更多資訊,請參見API 概覽。
我們將映像檢測相關的功能封裝成一個介面(例如圖片鑒黃、圖片涉政暴恐檢測、圖片OCR、圖片Logo檢測等),並提供以下兩種調用方式:
圖片同步檢測介面:支援對多張圖片進行檢測,同步返回所有檢測結果,建議一次檢測一張圖片。
圖片非同步檢測介面:支援對批量圖片進行檢測,介面將針對每一張圖片返回一個taskId,您需要在提交檢測任務後,通過taskId擷取檢測結果,對於批量圖片檢測,推薦使用該方式。
我們將視頻檢測相關的功能封裝成一個介面(例如視頻鑒黃、視頻涉政暴恐檢測、 視頻Logo檢測等),並提供以下兩種調用方式:
視頻同步檢測介面:只支援使用者自己將視頻截成圖片幀序列,傳遞圖片序列進行檢測,不推薦使用該方式。
視頻非同步檢測介面:支援使用者傳遞視頻進行檢測,您需要在提交檢測任務後,通過taskId擷取檢測結果或者通過設定回調介面接收檢測的結果回調通知,推薦您使用該方式進行視頻內容檢測。
語音反垃圾:語音垃圾內容檢測SDK支援語音流和語音檔案的檢測,目前只有非同步檢測介面,您需要在提交檢測任務後,通過taskId擷取檢測結果或者通過設定回調介面接收檢測的結果回調通知。
文本反垃圾:文本反垃圾只有同步檢測介面,您可以在一次請求中檢測一條或者多條文本。
在一個介面(例如圖片檢測)中調用多個情境進行檢測時,按照“每個情境的計費單價×檢測的內容量”進行計費。
開發準備
Alibaba Content Security ServiceSDK支援以下語言或環境:
下載SDK使用程式碼範例。
單擊 green-sdk-sample_doc下載SDK程式碼範例。
上述程式碼範例裡麵包含完整的Java、PHP、Python調用樣本,供您參考。
重要2018-05-09之前版本的介面已經下線,如果使用舊的版本號碼會返回HttpCode:400 , ErrorCode:InvalidAction.NotFound報錯,如遇報錯請更換為2018-05-09版本號碼。
參考第三方SDK。
如果您使用除Java、PHP、Python、Go、.NET以外的開發語言,推薦您通過HTTP請求直接調用內容檢測API;我們也收集了一些第三方開發人員編寫的Alibaba Content Security ServiceSDK,供您參考。Alibaba Content Security Service第三方SDK包括以下語言:c#、c++、nodejs、python(3.5)。具體內容,請參見其他語言 SDK。
說明對第三方SDK,阿里雲不提供後續維護,只作列舉參考。