API功能介紹
圖片審核2.0版API用於識別映像中是否有違反網路內容傳播相關規定、影響平台內容秩序、影響使用者體驗的內容或元素,支援40+的內容風險標籤和40+風險管控項。通過Alibaba Content Security Service的圖片審核2.0版,您可以根據業務所處的行業情境規範或平台內容治理規則,基於API返回的豐富的風險標籤和置信分,對具體圖片內容制定進一步的審核或治理措施。更多介紹,請參見圖片審核增強版2.0版介紹及計費說明。
接入指引
註冊阿里雲帳號:立即註冊,按照操作提示完成帳號註冊。
開通Alibaba Content Security Service隨用隨付:請確保您已開通服務,開通不收費,介面接入使用後系統會按使用量自動出賬,詳情請參見計費說明。
建立AccessKey:請確保您已通過RAM建立AccessKey,如果您使用的是子帳號AccessKey,您需要通過主帳號給子帳號賦予AliyunYundunGreenWebFullAccess許可權,具體操作,請參見RAM授權。
開發接入:推薦使用SDK方式調用,具體方法請詳見圖片審核增強版2.0版SDK及接入指南。
使用說明
您可以調用該介面建立圖片內容檢測任務。關於如何構造HTTP請求,請參見HTTP原生調用;您也可以直接選用已構造好的HTTP請求,更多資訊,請參見接入指南。
業務介面:ImageModeration
支援的地區及接入地址:
地區
外網接入地址
內網接入地址
支援服務
新加坡
https://green-cip.ap-southeast-1.aliyuncs.com
https://green-cip-vpc.ap-southeast-1.aliyuncs.com
baselineCheck_global、aigcDetector_global
英國(倫敦)
https://green-cip.eu-west-1.aliyuncs.com
暫無
美國(維吉尼亞)
https://green-cip.us-east-1.aliyuncs.com
https://green-cip-vpc.us-east-1.aliyuncs.com
baselineCheck_global、aigcDetector_global
美國(矽谷)
https://green-cip.us-west-1.aliyuncs.com
暫無
德國(法蘭克福)
green-cip.eu-central-1.aliyuncs.com
暫無
說明英國(倫敦)的配置複用新加坡地區控制台配置;美國(矽谷)和德國(法蘭克福)的配置複用美國(維吉尼亞)地區控制台配置。
計費資訊:
該介面為收費介面。僅對HTTP狀態代碼為200的請求進行計量計費,產生其他錯誤碼時不會計費。關於計費方式,請參見計費說明。
圖片要求:
圖片支援以下格式:PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、HEIF(該格式最長邊需小於8192 px)、GIF(取第一幀)、ICO(取最後一圖)。
圖片大小限制在20 MB以內,高或者寬不能超過16,384 px,且總像素不能超過1.67億 px。像素建議大於200*200(px),像素過低會影響Alibaba Content Security Service檢測演算法的效果。
圖片下載時間限制為3秒內,如果下載時間超過3秒,返回下載逾時。
QPS限制
本介面的單使用者QPS限制為100次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。如果您業務量級較大或者有緊急擴容需求需要更大QPS,請聯絡您的商務經理。
調試
在接入前,您也可以通過阿里雲OpenAPI線上調試圖片審核2.0版的介面,查看調用範例程式碼及SDK依賴資訊,方便概覽介面的使用方法和參數。
線上調試能力是基於當前登入帳號調用Alibaba Content Security Service的API介面,因此調用量會計入帳號的收費用量中。
請求參數
關於在請求中必須包含的公用請求參數,請參考公用參數。
請求body是一個JSON結構體,包含以下欄位:
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
Service | String | 是 | baselineCheck_global | 圖片檢測2.0版支援的檢測服務。取值:
說明 不同服務區別請參考服務說明。AIGC專用服務請參考AIGC情境檢測服務。出海版只能在海外地區使用。 |
ServiceParameters | JSONString | 是 | 內容檢測對象的相關參數集。JSON字串格式,關於每個字串的描述,請參見ServiceParameters。 |
表 1. ServiceParameters
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
imageUrl | String | 是。圖片審核增強版支援三種方式傳入圖片,請您選擇其中一種:
| https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png | 待檢測對象的URL,請確保該URL能通過公網訪問到,且URL地址長度不超過2048個字元。 說明 URL地址中不能包含中文,且一次請求請確保僅傳入1條URL。 |
ossBucketName | String | bucket_01 | 已授權OSS空間的Bucket名。 說明 使用OSS圖片內網地址時必須先使用阿里雲帳號(即主帳號)訪問雲資源訪問授權頁面進行AliyunCIPScanOSSRole的授權。 | |
ossObjectName | String | 2022023/04/24/test.jpg | 已授權OSS空間的檔案名稱。 說明 1、傳入OSS的原始檔案名,不支援再添加圖片參數處理,如需增加圖片處理參數請使用imageUrl地址。 2、檔案名稱有中文或空格按照原始傳入,不需要做URL編碼。 | |
ossRegionId | String | cn-beijing | OSS Bucket所在地區。 | |
dataId | String | 否 | img123**** | 檢測對象對應的資料ID。 由大小寫英文字母、數字、底線(_)、短劃線(-)、英文句號(.)組成,不超過64個字元,可以用於唯一標識您的業務資料。 |
referer | String | 否 | www.aliyun.com | referer要求標頭,用於防盜鏈等情境。長度不超過256個字元。 |
infoType | String | 是 | customImage,textInImage | 需要擷取的輔助資訊內容,取值:
支援指定多個內容,以英文逗號分隔。例如, “customImage,textInImage”表示同時返回自訂圖庫和圖片中文字資訊。 說明 人物資訊、標識標誌資訊支援在審核類型為圖片審核進階的Service中返回。更多資訊,請參考Service說明。 |
返回資料
名稱 | 類型 | 樣本值 | 描述 |
RequestId | String | 70ED13B0-BC22-576D-9CCF-1CC12FEAC477 | 本次調用請求的ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。 |
Data | Object | 圖片內容檢測結果。更多資訊,請參見Data。 | |
Code | Integer | 200 | 狀態代碼。更多資訊,請參見Code說明。 |
Msg | String | OK | 本次請求的響應訊息。 |
表 2. Data
名稱 | 類型 | 樣本值 | 描述 |
Result | Array | 圖片檢測的風險標籤、置信分等參數結果。更多資訊,請參見result。 | |
RiskLevel | String | high | 圖片風險等級,根據最高風險的標籤返回,傳回值包括:
說明 高風險內容建議直接處置;中風險內容建議人工複查;低風險內容建議在高召回需求時再做處理,日常建議和未檢測到風險做相同處理。風險分值可以在Alibaba Content Security Service控制台配置。 |
DataId | String | img123****** | 檢測對象對應的資料ID。 說明 如果在檢測請求參數中傳入了dataId,則此處返回對應的dataId。 |
Ext | Object | 圖片輔助參考資訊。更多資訊,請參見輔助資訊。 |
表 3. result
名稱 | 類型 | 樣本值 | 描述 |
Label | String | violent_explosion | 圖片內容檢測運算後返回的標籤。同一張圖片可能會檢出多個標籤和分值。支援的標籤,請參見: |
Confidence | Float | 81.22 | 置信分值,0到100分,保留到小數點後2位。部分標籤無置信分,更多資訊,請參見風險標籤釋義表。 |
Description | String | 煙火類內容 | 對Labal欄位的說明。 重要 該欄位為Label欄位的解釋說明,可能會變更調整,實際處理結果時建議處理Label欄位,不要基於該欄位進行結果處置。 |
RiskLevel | String | high | 當前標籤的風險等級,根據設定的高低風險分返回,傳回值包括:
|
樣本
請求樣本
{
"Service": "baselineCheck_global",
"ServiceParameters": {
"imageUrl": "https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png",
"dataId": "img123****"
}
}返回樣本
系統檢測到風險內容時,返回樣本:
{ "Msg": "OK", "Code": 200, "Data": { "DataId": "img123****", "Result": [ { "Label": "pornographic_adultContent", "Confidence": 81, "Description": "成人色情" }, { "Label": "sexual_partialNudity", "Confidence": 98, "Description": "肢體裸露或性感" }, { "Label": "violent_explosion", "Confidence": 70, "Description": "煙火類內容" }, { "Label": "violent_explosion_lib", "Confidence": 81, "Description": "煙火類內容_命中自訂庫" } ], "RiskLevel": "high" }, "RequestId": "ABCD1234-1234-1234-1234-1234XYZ" }當系統沒有檢測到風險內容時,返回樣本:
{ "Msg": "OK", "Code": 200, "Data": { "DataId": "img123****", "Result": [ { "Label": "nonLabel", "Description": "未檢測出風險" } ], "RiskLevel": "none" }, "RequestId": "ABCD1234-1234-1234-1234-1234XYZ" }
系統檢測到您傳入的圖片命中了您配置的免審圖庫時,返回樣本:
{ "Msg": "OK", "Code": 200, "Data": { "DataId": "img123****", "Result": [ { "Label": "nonLabel_lib", "Confidence": 83, "Description": "命中免審圖庫" } ], "RiskLevel": "none" }, "RequestId": "ABCD1234-1234-1234-1234-1234XYZ" }
文檔中的請求樣本和返回樣本為了便於閱讀,做了格式化處理,實際返回結果是沒有進行換行、縮排等處理。
風險標籤釋義表
以下是風險標籤值、對應的分值區間以及對應的含義。每個風險標籤均可以在控制台進行開關配置,部分風險標籤會提供更細分檢測範圍的開關配置。具體操作,請參見控制台操作指南。各圖片服務支援標籤如下:
情境 | 服務及標籤 |
通用情境 | |
AIGC情境 |
無風險或者命中免審圖庫時返回標籤參考無風險或者命中免審圖庫時支援標籤。
建議您將系統返回的風險標籤和置信分做一定周期的資料存放區,以便於在後續內容治理時參考,可根據風險標籤設定人工審核或標註的優先順序、分層分類的內容治理措施。
表 4. 通用基準檢測(baselineCheck_global)支援標籤
標籤值(label) | 置信分區間(confidence) | 中文含義 |
pornographic_adultContent | 0~100分,分數越高信賴度越高 | 畫面疑似含有成人與性相關的情況。 |
pornographic_cartoon | 0~100分,分數越高信賴度越高 | 畫面疑似含有卡通與性相關的情況。 |
pornographic_adultToys | 0~100分,分數越高信賴度越高 | 畫面疑似含有成人器具內容。 |
pornographic_art | 0~100分,分數越高信賴度越高 | 畫面疑似含有藝術品與性相關的情況。 |
pornographic_adultContent_tii | 0~100分,分數越高信賴度越高 | 圖中文字含與性相關的情況。 |
pornographic_suggestive_tii | 0~100分,分數越高信賴度越高 | 圖中文字含低俗內容。 |
pornographic_o_tii | 0~100分,分數越高信賴度越高 | 圖中文字含特殊類內容。更多資訊,請參見Alibaba Content Security Service控制台。 |
pornographic_organs_tii | 0~100分,分數越高信賴度越高 | 圖中文字含性器官描述內容。 |
pornographic_adultToys_tii | 0~100分,分數越高信賴度越高 | 圖中文字含成人玩具類內容。 |
sexual_suggestiveContent | 0~100分,分數越高信賴度越高 | 疑似含有疑似低俗或性暗示內容。 |
sexual_femaleUnderwear | 0~100分,分數越高信賴度越高 | 畫面疑似含有內衣泳衣內容。 |
sexual_cleavage | 0~100分,分數越高信賴度越高 | 畫面疑似含有女性乳溝特徵。 |
sexual_maleTopless | 0~100分,分數越高信賴度越高 | 畫面疑似含有男性赤膊內容。 |
sexual_cartoon | 0~100分,分數越高信賴度越高 | 疑似含有動漫類性感內容。 |
sexual_shoulder | 0~100分,分數越高信賴度越高 | 畫面疑似含有肩部性感內容。 |
sexual_femaleLeg | 0~100分,分數越高信賴度越高 | 畫面疑似含有腿部性感內容。 |
sexual_pregnancy | 0~100分,分數越高信賴度越高 | 畫面疑似含有孕照哺乳內容。 |
sexual_feet | 0~100分,分數越高信賴度越高 | 畫面疑似含有腳部性感內容。 |
sexual_kiss | 0~100分,分數越高信賴度越高 | 畫面疑似含有親吻內容。 |
sexual_intimacy | 0~100分,分數越高信賴度越高 | 畫面疑似含有親密行為內容。 |
sexual_intimacyCartoon | 0~100分,分數越高信賴度越高 | 畫面疑似含有卡通動漫親密動作。 |
violent_explosion | 0~100分,分數越高信賴度越高 | 疑似含有煙火類內容元素。更多資訊,請參見Alibaba Content Security Service控制台。 |
violent_burning | 0~100分,分數越高信賴度越高 | 畫面疑似包含燃燒內容。 |
violent_armedForces | 0~100分,分數越高信賴度越高 | 畫面疑似包含暴恐組織。 |
violent_weapon | 0~100分,分數越高信賴度越高 | 畫面疑似包含軍器裝備。 |
violent_crowding | 0~100分,分數越高信賴度越高 | 畫面疑似有人群聚集。 |
violent_gun | 0~100分,分數越高信賴度越高 | 畫面疑似包含槍支。 |
violent_knives | 0~100分,分數越高信賴度越高 | 畫面疑似包含刀具。 |
violent_horrific | 0~100分,分數越高信賴度越高 | 畫面疑似包含驚悚內容。 |
violent_nazi | 0~100分,分數越高信賴度越高 | 畫面疑似包含納粹內容。 |
violent_bloody | 0~100分,分數越高信賴度越高 | 畫面疑似包含血腥內容。 |
violent_extremistGroups_tii | 0~100分,分數越高信賴度越高 | 圖中文字含暴恐組織內容。 |
violent_extremistIncident_tii | 0~100分,分數越高信賴度越高 | 圖中文字含暴恐事件內容。 |
violence_weapons_tii | 0~100分,分數越高信賴度越高 | 圖中文字含槍支刀具的描述。 |
violent_ACU | 0~100分,分數越高信賴度越高 | 畫面疑似包含作戰服。 |
contraband_drug | 0~100分,分數越高信賴度越高 | 畫面含有疑似毒品內容。 |
contraband_drug_tii | 0~100分,分數越高信賴度越高 | 圖中文字疑似描述違禁毒品。 |
contraband_gamble | 0~100分,分數越高信賴度越高 | 畫面疑似含有賭博內容。 |
contraband_gamble_tii | 0~100分,分數越高信賴度越高 | 圖中文字疑似描述賭博行為。 |
inappropriate_smoking | 0~100分,分數越高信賴度越高 | 畫面疑似含有煙相關內容。 |
inappropriate_drinking | 0~100分,分數越高信賴度越高 | 畫面疑似含有酒相關內容。 |
inappropriate_tattoo | 0~100分,分數越高信賴度越高 | 畫面疑似含有紋身內容。 |
inappropriate_middleFinger | 0~100分,分數越高信賴度越高 | 畫面疑似含有豎中指內容。 |
inappropriate_foodWasting | 0~100分,分數越高信賴度越高 | 畫面疑似含有浪費糧食內容。 |
profanity_Offensive_tii | 0~100分,分數越高信賴度越高 | 圖中文字疑似含有較嚴重辱罵,言語攻擊/冒犯等內容。 |
profanity_Oral_tii | 0~100分,分數越高信賴度越高 | 圖中文字疑似含有口頭語性質的辱罵。 |
religion_clothing | 0~100分,分數越高信賴度越高 | 畫面疑似含有特殊標識和元素。更多資訊,請參見Alibaba Content Security Service控制台。 |
religion_logo | 0~100分,分數越高信賴度越高 | |
religion_flag | 0~100分,分數越高信賴度越高 | |
religion_taboo1_tii | 0~100分,分數越高信賴度越高 | 圖中文字含禁忌類內容。更多資訊,請參見Alibaba Content Security Service控制台。 |
religion_taboo2_tii | 0~100分,分數越高信賴度越高 | |
flag_country | 0~100分,分數越高信賴度越高 | 畫面疑似含有旗幟相關內容。 |
political_historicalNihility | 0~100分,分數越高信賴度越高 | 圖中含特定內容。更多資訊,請參見Alibaba Content Security Service控制台。 |
political_historicalNihility_tii | 0~100分,分數越高信賴度越高 | |
political_politicalFigure_1 | 0~100分,分數越高信賴度越高 | |
political_politicalFigure_2 | 0~100分,分數越高信賴度越高 | |
political_politicalFigure_3 | 0~100分,分數越高信賴度越高 | |
political_politicalFigure_4 | 0~100分,分數越高信賴度越高 | |
political_politicalFigure_name_tii | 0~100分,分數越高信賴度越高 | |
political_prohibitedPerson_1 | 0~100分,分數越高信賴度越高 | |
political_prohibitedPerson_2 | 0~100分,分數越高信賴度越高 | |
political_prohibitedPerson_tii | 0~100分,分數越高信賴度越高 | |
political_taintedCelebrity | 0~100分,分數越高信賴度越高 | |
political_taintedCelebrity_tii | 0~100分,分數越高信賴度越高 | |
political_CNFlag | 0~100分,分數越高信賴度越高 | |
political_CNMap | 0~100分,分數越高信賴度越高 | |
political_logo | 0~100分,分數越高信賴度越高 | |
political_outfit | 0~100分,分數越高信賴度越高 | |
political_badge | 0~100分,分數越高信賴度越高 | |
pt_logo | 0~100分,分數越高信賴度越高 | 畫面疑似含有LOGO內容。 |
QRCode | 0~100分,分數越高信賴度越高 | 畫面疑似含有二維碼內容。 |
pt_custom_01 | 0~100分,分數越高信賴度越高 | 自訂標籤01。 |
pt_custom_02 | 0~100分,分數越高信賴度越高 | 自訂標籤02。 |
tii為text in image的縮寫,結尾為tii的標籤代表命中了圖片中的文字違規內容。
此外,上述每個風險標籤也支援配置自訂圖庫實現,如檢測的圖片與自訂圖庫中的圖片相似性高,則系統會返回對應的風險標籤。為了便於區分,標籤值(label)格式為原風險標籤值_lib。例如,您對“violent_explosion”配置了自訂圖庫,當檢測的圖片匹配到自訂圖庫中的任一一張圖片且相似性較高,系統會在label參數中返回violent_explosion_lib,對應的 confidence參數會以分值的形式代表相似程度。
當系統對傳入的圖片檢測未發現異常,或著與您配置的免審圖片中任一一張相似性高,則系統返回的標籤值和置信分滿足如下表格。
標籤值(label) | 置信分區間(confidence) | 中文含義 |
nonLabel | 無該欄位 | 該圖片未檢測出風險,或者您已全關閉檢測項。更多資訊,請參見Alibaba Content Security Service控制台。 |
nonLabel_lib | 0~100分,分數越高信賴度越高 | 該圖片與您選配的免審圖片中存在較高相似性。更多資訊,請參見Alibaba Content Security Service控制台。 |
Code說明
以下為介面返回code的含義說明,系統僅對code返回為200的請求計量計費,其他code不會計費。
Code | 說明 |
200 | 請求正常。 |
400 | 請求參數為空白。 |
401 | 請求參數錯誤。 |
402 | 請求參數長度不符合介面規定,請檢查並修改。 |
403 | 請求超過QPS限制,請檢查並調整並發。 |
404 | 傳入的圖片下載遇到錯誤,請檢查或重試。 |
405 | 傳入的圖片下載逾時,可能是因為圖片無法訪問,請檢查調整後重試。 |
406 | 傳入的圖片過大,請檢查調整圖片大小後再重試。 |
407 | 傳入的圖片格式暫不支援,請檢查調整後重試。 |
408 | 該帳號無許可權調用該介面,可能是帳號未開通或者已欠費,或者調用帳號未被授權訪問。 |
500 | 系統異常。 |