本文介紹內容審核(imageaudit)類目下的圖片內容安全ScanImage的語法及示例。
功能描述
圖片內容安全結合行為、內容,采用多維度、多模型、多檢測手段,識別圖片中的敏感信息,規避圖片中存在敏感人物照片、敏感事件等內容風險。
支持檢測的場景包括:圖片智能鑒黃、圖片敏感內容識別、圖片風險人物識別、圖片垃圾廣告識別、圖片不良場景識別、圖片Logo識別。
在提交檢測任務時,您需要指定scenes參數,并且支持組合使用,即可對同一張圖片的多種風險進行檢測。
- 在同時檢測多個scene的情況下,將按照每個場景的檢測圖片數量×每個場景的單價進行累加計費。而在檢測返回結果中,則包含了您指定的scenes對應的label。您可以根據參數的返回值判斷風險的具體類型。然后對圖片進行處理。
- 您可以進入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
在圖片審核中,scene與label的對應關系如下:
scene |
描述 |
label |
---|---|---|
porn |
圖片智能鑒黃:適用于圖片涉及色情、低俗內容檢測。 |
normal(正常圖片)、sexy(性感圖片)、porn(色情圖片) |
terrorism |
圖片敏感內容識別:適用于圖片涉及敏感事件、暴力、武器、恐怖、血腥、爆炸等內容識別。 圖片風險人物識別:適用于圖片涉及敏感人物、明星的識別。 |
normal(正常圖片)、bloody(血腥)、explosion(爆炸煙光)、outfit(特殊裝束)、logo(特殊標識)、weapon(武器)、politics(敏感內容)、violence(打斗)、crowd(聚眾)、parade(游行)、carcrash(車禍現場)、flag(旗幟)、location(地標)、drug(涉毒)、gamble(賭博)、others(其他) |
ad |
圖片垃圾廣告識別:適用于圖片中含有廣告信息的識別,特別是針對于類似牛皮癬的文字廣告有較好的識別效果。 |
normal(正常圖片)、politics(文字含敏感內容)、porn(文字含涉黃內容)、abuse(文字含辱罵內容)、terrorism(文字含涉恐內容)、contraband(文字含違禁內容)、spam(文字含其他垃圾內容)、npx(牛皮癬廣告)、qrcode(包含二維碼)、programCode(包含小程序碼)、ad(其他廣告) |
live |
圖片不良場景識別:適用于圖片中涉及毒品、賭博、畫中畫等內容的識別。 |
normal(正常圖片)、meaningless(無意義圖片)、PIP(畫中畫)、smoking(吸煙)、drivelive(車內直播)、drug(涉毒)、gamble(賭博) |
logo |
圖片Logo識別:適用于圖片中含有臺標、水印、商標等內容的檢測。 |
normal(正常圖片)、TV(帶有管控logo的圖片)、trademark(商標) |
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通內容審核服務,若未開通服務請立即開通。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為內容審核(imageaudit)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 示例代碼:該能力常用語言的示例代碼,請參見圖片內容安全示例代碼。
7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
- 圖像大小:不超過10 MB。如果您有大圖需求,請通過釘釘群(23109592)聯系我們。
- 圖像分辨率:建議大于256×256像素,像素過低可能會影響識別效果。超長圖的分辨率長或寬不能超過30000像素。GIF圖總像素(長x寬)不超過4194304像素,超過該總像素值會報InvalidFile.Download(文件無法下載)錯誤。
- URL地址中不能包含中文字符。
檢測說明
- 最長檢測時間是6秒,如果在該時間范圍內沒有完成檢測,系統會返回超時錯誤碼。
- 圖片下載時間限制為3秒,如果下載時間超過3秒,則會返回下載超時。
- 圖片檢測接口響應時間依賴圖片的下載時間。請確保被檢測圖片所在的存儲服務穩定可靠,建議您使用阿里云OSS存儲或者CDN緩存。
計費說明
關于圖片內容安全的計費方式及報價,請參見計費介紹。
能力 |
體驗中心 |
---|---|
圖片智能鑒黃 |
|
圖片敏感內容識別 |
|
圖片Logo識別 |
|
圖片垃圾廣告識別 |
|
圖片不良場景識別 |
|
圖片風險人物識別 |
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ScanImage | 系統規定參數。取值:ScanImage。 |
Task.N.ImageTimeMillisecond | Long | 否 | 1 | 圖片創建或編輯時間,單位為毫秒。 |
Task.N.Interval | Integer | 否 | 1 | 截幀頻率,GIF圖或者長圖檢測專用。GIF圖可理解為圖片數組,每interval張圖片抽取一張進行檢測。只有該值存在時,才會對GIF進行截幀。長圖同時支持長豎圖和長橫圖。
說明 默認只會檢測GIF圖或長圖的第一幀,interval參數用于指示后臺在檢測時可按照該間隔跳著檢測,以節省檢測成本。需要與maxFrames參數組合使用。例如,設置interval為2,maxFrames為100,檢測長圖或GIF圖時,將每間隔1幀檢測一次,最多檢測100幀,計費則按照實際檢測的數量計算。 |
Task.N.ImageURL | String | 是 | http://xxx.xxx.com/xxx.jpg | 待檢測圖像的URL地址。支持HTTP和HTTPS協議。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 說明 如果使用上海地域的OSS鏈接,系統會自動將OSS鏈接地址轉成內網地址然后再下載文件,所以調用該接口并不會產生OSS流量計費。 |
Task.N.MaxFrames | Integer | 否 | 1 | 最大截幀數量,GIF圖或長圖檢測專用,默認值為1。 當interval*maxFrames小于該圖片所包含的圖片數量時,截幀間隔會自動修改為 |
Task.N.DataId | String | 否 | uuid-xxxx-xxxx-1234 | 數據ID。需要保證在一次請求中所有的ID不重復。 |
Scene.N | String | 否 | porn | 指定圖片檢測的應用場景,可選值包括:
說明 支持多場景(scenes)一起檢測。例如 scenes=[“porn”, “terrorism”] ,即對一張圖片同時進行鑒黃和涉恐識別,此時也會按照兩個場景計費。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 69B41AE8-1234-1234-1234-12D395695D2D | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
Results | Array of Result | 圖片檢測結果。 |
|
ImageURL | String | http://xxx.xxx.xxx/xxx.jpg | 圖像URL地址。 |
DataId | String | uuid-xxxx-xxx-1234 | 數據ID。 |
SubResults | Array of SubResult | 單張圖片的檢測結果。 |
|
SfaceDataList | Array of SfaceData | 圖片中包含暴恐敏感內容時,返回識別出來的暴恐敏感信息。 說明 僅適用于terrorism和sface場景。關于該參數在sface場景中的具體內容,請參見敏感人臉檢測。 |
|
Width | Float | 97 | 人臉區域寬度。 |
Faces | Array of Face | 識別出的人臉信息。 |
|
Name | String | abc | 相似人物的名稱。 |
Id | String | AliFace_0001234 | 人臉ID。 |
Rate | Float | 91.54 | 相似概率。 |
Height | Float | 131 | 人臉區域高度。 |
Y | Float | 39 | 以圖片左上角為坐標原點,人臉區域左上角到x軸距離。 |
X | Float | 49 | 以圖片左上角為坐標原點,人臉區域左上角到y軸距離。 |
HintWordsInfoList | Array of HintWordsInfo | 圖片中含有廣告時,返回圖片中廣告文字命中的風險關鍵詞信息。格式為數組。 說明 僅適用于ad場景。示例值: ”hintWordsInfo”:[{“context”:”敏感詞”}] 。 |
|
Context | String | abc | 圖片中文字命中的風險關鍵詞內容。 |
Suggestion | String | block | 建議您執行的操作。
|
ProgramCodeDataList | Array of ProgramCodeData | 圖片中含有小程序碼時,返回小程序碼的位置信息。 說明 僅適用于qrcode場景,且已通過釘釘群(23109592)聯系我們開通了小程序碼識別。 |
|
Width | Float | 402.0 | 小程序碼區域寬度。 |
Height | Float | 413.0 | 小程序碼區域高度。 |
Y | Float | 0.0 | 以圖片左上角為坐標原點,小程序碼區域左上角到x軸距離。 |
X | Float | 11.0 | 以圖片左上角為坐標原點,小程序碼區域左上角到y軸距離。 |
OCRDataList | Array of String | abc | 識別到的圖片中的完整文字信息。 |
Frames | Array of Frame | 如果待檢測圖片因為過長被截斷,該參數返回截斷后的每一幀圖像的臨時訪問地址供您參考。 |
|
URL | String | http://xxx.xxx.com/xxx-0.jpg | 被截斷的圖片的臨時訪問URL,地址有效期是5分鐘。 |
Rate | Float | 89.85 | 結果為該分類的概率,取值范圍為0~100。值越高,表示越有可能屬于該分類。 |
LogoDataList | Array of LogoData | 圖片中含有Logo時,返回識別出來的Logo信息。 說明 僅適用于Logo場景。 |
|
Type | String | TV | 識別出的logo類型,取值為TV(臺標)。 |
Width | Float | 106 | Logo區域寬度。 |
Height | Float | 106 | Logo區域高度。 |
Y | Float | 68 | 以圖片左上角為坐標原點,Logo區域左上角到x軸距離。 |
Name | String | abc | 識別出的Logo名稱。 |
X | Float | 140 | 以圖片左上角為坐標原點,Logo區域左上角到y軸距離。 |
Label | String | normal | 檢測結果的分類,與具體的scene對應。取值范圍參見scene和label對應關系說明。 |
Scene | String | ad | 圖片檢測場景,和調用請求中的場景(scenes)對應。 |
Rate | Float | 99.91 | 結果為該分類的概率,取值范圍為0~100。值越高,表示越有可能屬于該分類。 |
TaskId | String | img4wlJcb7p4wH4lAP3111111-123456 | 任務ID。 |
SDK參考
阿里云視覺AI內容審核類目下的圖片內容安全能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為內容審核(imageaudit)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言的示例代碼,請參見圖片內容安全示例代碼。
示例
請求示例
http(s)://imageaudit.cn-shanghai.aliyuncs.com/?Action=ScanImage //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&Task=[{"ImageTimeMillisecond":1,"Interval":1,"ImageURL":"http://xxx.xxx.com/xxx.jpg","MaxFrames":1,"DataId":"uuid-xxxx-xxxx-1234"}]
&Scene=["porn"]
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<Data>
<Results>
<Code>200</Code>
<Message>OK</Message>
<DataId>uuid-xxxx-xxx-1234</DataId>
<SubResults>
<Rate>99.63</Rate>
<Suggestion>block</Suggestion>
<Label>sexy</Label>
<Scene>porn</Scene>
</SubResults>
<SubResults>
<Label>politics</Label>
<Rate>91.54</Rate>
<Scene>terrorism</Scene>
<SfaceDataList>
<Faces>
<Id>AliFace_0001234</Id>
<Name>命中人名</Name>
<Rate>91.54</Rate>
</Faces>
<Height>131</Height>
<Width>97</Width>
<X>49</X>
<y>39</y>
</SfaceDataList>
<Suggestion>block</Suggestion>
</SubResults>
<SubResults>
<ProgramCodeDataList>
<Width>402</Width>
<Height>413</Height>
<X>11</X>
<y>0</y>
</ProgramCodeDataList>
<Frames>
<Rate>89.85</Rate>
<URL>http://xxx.xxx.com/xxx-0.jpg</URL>
</Frames>
<Frames>
<Rate>68.06</Rate>
<URL>http://xxx.xxx.com/xxx-1.jpg</URL>
</Frames>
<Rate>99.91</Rate>
<Suggestion>block</Suggestion>
<Label>ad</Label>
<Scene>ad</Scene>
</SubResults>
<SubResults>
<Rate>99.91</Rate>
<Suggestion>block</Suggestion>
<Label>drug</Label>
<Scene>live</Scene>
</SubResults>
<SubResults>
<LogoDataList>
<Name>xxx臺</Name>
<Type>TV</Type>
<X>140</X>
<y>68</y>
<Width>106</Width>
<Height>106</Height>
</LogoDataList>
<Rate>99.9</Rate>
<Suggestion>block</Suggestion>
<Label>TV</Label>
<Scene>logo</Scene>
</SubResults>
<TaskId>img4wlJcb7p4wH4lAP3111111-123456</TaskId>
<ImageURL>http://xxx.xxx.xxx/xxx.jpg</ImageURL>
</Results>
</Data>
<RequestId>69B41AE8-1234-1234-1234-12D395695D2D</RequestId>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Data" : {
"Results" : [ {
"Code" : 200,
"Message" : "OK",
"DataId" : "uuid-xxxx-xxx-1234",
"SubResults" : [ {
"Rate" : 99.63,
"Suggestion" : "block",
"Label" : "sexy",
"Scene" : "porn"
}, {
"Label" : "politics",
"Rate" : 91.54,
"Scene" : "terrorism",
"SfaceDataList" : [ {
"Faces" : [ {
"Id" : "AliFace_0001234",
"Name" : "命中人名",
"Rate" : 91.54
} ],
"Height" : 131,
"Width" : 97,
"X" : 49,
"y" : 39
} ],
"Suggestion" : "block"
}, {
"ProgramCodeDataList" : [ {
"Width" : 402.0,
"Height" : 413.0,
"X" : 11.0,
"y" : 0.0
} ],
"Frames" : [ {
"Rate" : 89.85,
"URL" : "http://xxx.xxx.com/xxx-0.jpg"
}, {
"Rate" : 68.06,
"URL" : "http://xxx.xxx.com/xxx-1.jpg"
} ],
"Rate" : 99.91,
"Suggestion" : "block",
"Label" : "ad",
"Scene" : "ad"
}, {
"Rate" : 99.91,
"Suggestion" : "block",
"Label" : "drug",
"Scene" : "live"
}, {
"LogoDataList" : [ {
"Name" : "xxx臺",
"Type" : "TV",
"X" : 140,
"y" : 68,
"Width" : 106,
"Height" : 106
} ],
"Rate" : 99.9,
"Suggestion" : "block",
"Label" : "TV",
"Scene" : "logo"
} ],
"TaskId" : "img4wlJcb7p4wH4lAP3111111-123456",
"ImageURL" : "http://xxx.xxx.xxx/xxx.jpg"
} ]
},
"RequestId" : "69B41AE8-1234-1234-1234-12D395695D2D"
}
錯誤碼
關于圖片內容安全的錯誤碼,詳情請參見常見錯誤碼。
開源模型體驗
更多開源免費模型體驗及下載,詳見魔搭社區:內容審核模型-鑒黃。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。