本文介紹了如何使用內容安全服務提供的內容檢測API SDK。
SDK使用說明
在使用SDK前,需了解各個接口的具體功能。更多信息,請參見API 概覽。
我們將圖像檢測相關的功能封裝成一個接口(例如圖片鑒黃、圖片涉政暴恐檢測、圖片OCR、圖片Logo檢測等),并提供以下兩種調用方式:
圖片同步檢測接口:支持對多張圖片進行檢測,同步返回所有檢測結果,建議一次檢測一張圖片。
圖片異步檢測接口:支持對批量圖片進行檢測,接口將針對每一張圖片返回一個taskId,您需要在提交檢測任務后,通過taskId獲取檢測結果,對于批量圖片檢測,推薦使用該方式。
我們將視頻檢測相關的功能封裝成一個接口(例如視頻鑒黃、視頻涉政暴恐檢測、 視頻Logo檢測等),并提供以下兩種調用方式:
視頻同步檢測接口:只支持用戶自己將視頻截成圖片幀序列,傳遞圖片序列進行檢測,不推薦使用該方式。
視頻異步檢測接口:支持用戶傳遞視頻進行檢測,您需要在提交檢測任務后,通過taskId獲取檢測結果或者通過設置回調接口接收檢測的結果回調通知,推薦您使用該方式進行視頻內容檢測。
語音反垃圾:語音垃圾內容檢測SDK支持語音流和語音文件的檢測,目前只有異步檢測接口,您需要在提交檢測任務后,通過taskId獲取檢測結果或者通過設置回調接口接收檢測的結果回調通知。
文本反垃圾:文本反垃圾只有同步檢測接口,您可以在一次請求中檢測一條或者多條文本。
在一個接口(例如圖片檢測)中調用多個場景進行檢測時,按照“每個場景的計費單價×檢測的內容量”進行計費。
開發準備
內容安全SDK支持以下語言或環境:
下載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;我們也收集了一些第三方開發者編寫的內容安全SDK,供您參考。內容安全第三方SDK包括以下語言:c#、c++、nodejs、python(3.5)。具體內容,請參見其他語言 SDK。
說明對第三方SDK,阿里云不提供后續維護,只作列舉參考。
技術答疑
如果您在接入API或SDK的過程中遇到問題,可以搜索釘釘群號(35573806)加入內容安全技術答疑群。加群時請備注您的公司名稱+職位類型(研發、產品或者審核),例如XXX公司+研發。