本文介紹內容審核(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進行截幀。長圖同時支持長豎圖和長橫圖。

  • 長豎圖(高大于400像素,高寬比大于2.5),會按照高/寬取整來計算總圖數,并進行切割。
  • 長橫圖(寬大于400像素,寬高比大于2.5),會按照寬/高取整來計算總圖數,并進行切割。
說明 默認只會檢測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小于該圖片所包含的圖片數量時,截幀間隔會自動修改為該圖片所包含的圖片數/maxFrames,以提高整體檢測效果。

Task.N.DataId String uuid-xxxx-xxxx-1234

數據ID。需要保證在一次請求中所有的ID不重復。

Scene.N String porn

指定圖片檢測的應用場景,可選值包括:

  • porn:圖片智能鑒黃
  • terrorism:圖片敏感內容識別、圖片風險人物識別
  • ad:圖片垃圾廣告識別
  • live:圖片不良場景識別
  • logo:圖片Logo識別
說明 支持多場景(scenes)一起檢測。例如scenes=[“porn”, “terrorism”],即對一張圖片同時進行鑒黃和涉恐識別,此時也會按照兩個場景計費。
說明 最多指定10個檢測對象,即最多同時對10張圖片進行檢測。

返回數據

名稱 類型 示例值 描述
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

建議您執行的操作。

  • pass:圖片正常,無需進行其余操作;或者未識別出目標對象。
  • review:檢測結果不確定,需要進行人工審核;或者未識別出目標對象。
  • 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小時后會被系統自動清理刪除。