本文介紹Image Search服務的圖片查詢方法。

背景信息

Image Search服務支援通過API、SDK（推薦方式）和控制台（適用於功能體驗情境）三種方式進行圖片查詢。

控制台方式

  1. 單擊圖片搜尋。
    1
    參數 說明 是否必選
    搜尋類型 包括兩種搜尋類型：
    • SearchByPic：根據圖片搜尋相似圖片。預設選項。
    • SearchByName：根據已添加的圖片搜尋相似圖片。
    		 是
    上傳圖片 圖片內容本身，Base64編碼。新增圖片具體要求如下：
    • 圖片大小要求不超過4 MB。
    • 圖片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。
    • 傳輸等待時間不超過5秒。
    • 服務類型為商品圖片搜尋和通用圖片搜尋時，圖片長和寬像素要求大於等於100且小於等於4096。
    • 圖片中不能包含旋轉資訊。
    		 是
    圖片主體識別 在圖片搜尋過程中是否需要對上傳圖片進行主體識別。
    • 為true時：進行主體識別，包括系統自動識別和自訂主體識別。具體請參見主體識別方式參數介紹。
    • 為false時：不進行主體識別，以整張圖進行搜尋。
    		 是
    主體識別方式 主體識別的方式：
    • 系統自動識別：由系統自動進行主體識別，以識別的主體進行搜尋，主體識別結果可以在Response中擷取。
    • 自訂主體地區：可自訂主體識別地區。格式為x1,x2,y1,y2，其中x1,y1為左上方點，x2,y2為右下角點。單擊此選項可以通過拖拽的方式框選圖片主體地區。若不設定自訂主體地區，則以整張圖進行搜尋。
    		是
    圖片類目 圖片類目即CategoryId。圖片搜尋過程中可以指定圖片所屬類目，詳情請參見類目參考。
    说明
    • 對於商品搜尋，如果設定類目，則以設定的為準；若不設定類目，將由系統進行類目預測，預測的類目結果可在Response中擷取 。
    • 對於通用搜尋，不論是否設定類目，系統都會將類目設定為88888888。
    		 否
    返回結果數 返回相似結果的最大值。取值範圍1~100。預設值為10。 否
    結果起始位置 返回相似結果的起始位置。取值範圍0~499。預設值為0。 否
    過濾條件 搜尋時可以設定過濾條件，只返回符合過濾條件的映像結果，比如只返回ownerId為1000的映像結果，或者只返回公司名稱為”alibaba”的映像結果。
    说明
    • int_attr支援的操作符有>、>=、<、<=、=。
    • str_attr支援的操作符有=和!=。
    • 多個條件之間支援AND和OR進行串連。
    • 例如：int_attr=1000 AND str_attr=”value1”。
    		 否
  2. 查看返回結果。
    返回結果參數描述如下。
    參數 類型 樣本值 說明
    Success Boolean true 請求是否成功。
    RequestId String 36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1 請求ID。
    Code Integer 0 錯誤碼：
    • 0表示成功。
    • 非0表示失敗。
    Message String success 錯誤資訊。
    Head - - 搜尋結果資訊。
    └DocsReturn Integer 10 返回結果數目。
    └DocsFound Integer 10000 執行個體中命中結果數目。
    └SearchTime Integer 95 搜尋耗時，單位毫秒。
    PicInfo - - 類目預測、主體識別結果等資訊。
    └CategoryId Integer 88888888 類目預測結果。若請求中指定了類目，則以請求中指定為準。
    └Region String 280,486,232,351 主體識別結果。圖片的主體地區，格式為x1,x2,y1,y2, 其中x1和y1是左上方的點，x2和y2是右下角的點。若使用者請求中指定了主體地區，則以請求中指定為準。
    └AllCategories - - 系統支援的所有類目資訊。
    └Name String Tops 類目名稱。
    └Id Integer 0 類目ID。
    Auctions - - 所有返回商品的描述資訊。
    └CustomContent String Demo Custom Content 使用者自訂內容。
    └PicName String DemoPic 圖片名稱。
    └CategoryId Integer 0 圖片類目。
    └ProductId String test 商品ID。
    └SortExprValues String 7.33136443711219e+24;0 系統打分資訊。
    说明 SortExprValues是一個分號分隔的二元組，第一個值表示圖片的相關性分數，值越大表示和查詢的圖片相關性越高。您只需要關注第一個值即可。
    └IntAttr Integer 0 整數類型屬性。
    └StrAttr String demoStrAttr 字串類型屬性。

API方式

通過HTTP或HTTPS協議直接存取，需要按照簽名機制進行身分識別驗證，發送請求的RequestBody需要按照給定的格式進行傳輸。通過API查詢相似圖片的qps為購買的套餐包的qps。更多詳情請參見查詢圖片。

SDK方式（推薦）

Image Search服務提供多個版本的SDK，您無需關注簽名驗證以及RequestBody格式拼裝等繁瑣的事情。通過SDK查詢相似圖片的qps為購買的套餐包的qps。更多詳情請見SDK參考。