日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 圖像搜索 實踐教程 圖像上傳

圖像上傳

更新時間：
產品詳情
我的收藏

本文介紹如何將圖像上傳到圖像搜索服務。

說明

如需了解更多產品詳情和獲取技術支持，請單擊在線咨詢或通過釘釘群（35035130）聯系我們。

背景信息

圖像搜索提供兩種方式上傳圖片，一種是通過圖像搜索產品API或者SDK，另一種方式是通過借助阿里云OSS通過批量操作進行上傳。

  • 如果您僅上傳少量圖片，建議您使用API或SDK方式。詳情請參見新增圖片。

  • 如果您是企業級的用戶，或者您需要批量上傳圖片，但圖片沒有存儲在阿里云OSS，可使用OSSImport工具將圖片存儲在阿里云OSS上，然后進行批量上傳。具體步驟請參見操作流程。

  • 如果您是企業級的用戶，或者您需要批量上傳圖片，且圖片已經存儲在阿里云OSS。請參見批量操作。

    重要

    使用圖像搜索的批量操作功能，需保證圖像搜索和阿里云OSS在同一區域。

OSSImport介紹

OSSImport是阿里云OSS提供的一款將數據遷移至OSS存儲空間（Bucket）的工具。您可以將OSSImport部署在本地服務器或云上ECS實例內，輕松將您本地或其它云存儲的數據遷移到OSS。

使用OSSImport上傳圖片具有以下優勢：

  • 保持圖片快速更新到圖像搜索引擎。

  • 同一個OSS存儲空間可供不同環境使用，像開發項目，線上項目等。

  • 根據業務需要，更好地組織和管理多種圖片的來源。

  • 更好地管理復雜環境的項目，例如開發項目，UAT項目等。

  • 優化使用網絡帶寬：一次上傳，多次使用。

  • 使用這個工具，您可以將圖像搜索管理產業化。

圖片限制

  • 單張圖片大小不超過4 MB。

  • 圖片的長和寬分辨率要求大于100px小于等于4096px。

操作流程

步驟一：下載OSSImport工具

OSSImport有單機模式和分布式模式兩種部署方式。

  • 單機模式：當您需要遷移的數據小于30TB時，推薦部署單機模式。您可以將OSSImport部署在任意一臺可以訪問待遷移數據，且可以訪問OSS的機器上。單擊OSSImport下載。

  • 分布式模式：當您需要遷移的數據大于30TB時，推薦使用分布式模式。您可以將OSSImport部署在任意多臺可以訪問您待遷移數據，且可以訪問OSS的機器上。單擊OSSImport下載。

說明

當您遷移的數據過大時，為了節約時間，您可以將OSSImport部署到與您OSS相同地域的ECS實例上，并通過專線將源數據存放的服務器掛載到阿里云VPC網絡中。多臺ECS實例將數據通過內網遷移至OSS，會極大的提升數據遷移效率。

步驟二：開通對象存儲OSS

具體操作步驟請參見開通OSS服務進行開通。

步驟三：創建存儲空間（bucket）

具體操作步驟請參見控制臺創建存儲空間。

說明

請確保開通的OSS服務以及創建的Bucket與已購買的圖像搜索服務在同一個地域。

步驟四：導入increment.meta 數據

在OSS服務中存放圖片的路徑下，新建increment.meta文件，該文件用來存儲批量操作任務相關內容。

說明

  1. increment.meta文件中涉及的圖片必須和increment.meta文件在同一Bucket下，否則批量操作會失敗。

  2. increment.meta文件名稱是固定的，圖像搜索將根據此文件名稱讀取批量操作相關內容，不要擅自修改文件名稱，否則會操作失敗。

  3. 圖像搜索批量操作支持同一Bucket，不同路徑（path）圖片的批量操作，例如：Bucket為imagesearch，increment.meta文件在此Bucket的根目錄下，path為girlCloth，圖片在此path目錄下，圖片名稱為girl_cloth8.jpg，則meta文件中PicName應寫為“PicName":"girlCloth/girl_cloth8.jpg"，注意：必須寫成"girlCloth/girl_cloth8.jpg"，在girlCloth前面和girl_cloth8.jpg后面都不能加正斜線(/)。如果有多級目錄按照此邏輯依次類推。

  4. 在OSS中的圖片名稱后綴必須填寫，例如圖片名稱為girl_cloth10.jpg，不能寫為"PicName":"girl_cloth10"，必須寫為"PicName":"girl_cloth10.jpg"，否則會處理失敗。

  5. increment.meta文件中，一行代表處理一張圖片，處理另一張圖片必須換行，不得將所有圖片處理寫到一行中，否則會處理失敗。

文件參考示例如下：

{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth1.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value1","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth2.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value2","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1001","PicName": "girl_cloth3.jpg","CategoryId": 1,"CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1002","PicName": "girl_cloth4.jpg","CategoryId": 0,"CustomContent": "k1:v1,k2:v2,k3:v3","Crop": false}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth7.jpg","CustomContent": "https://www.aliyun.com/imagesearch/girl_cloth7.jpg"}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth6.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1006","PicName": "girlCloth/girl_cloth10.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}

每個圖片由JSON格式表示，具體字段含義如下表所示：

參數

類型

是否必選

說明

OperationType

String

是

操作類型。

  • ADD：新增圖片。

  • DELETE：刪除圖片。

ProductId

String

是

圖片唯一標識符，最多支持512個字符。

PicName

String

是

圖片名稱。OSS的Bucket中圖片名稱。最多支持512個字符。

重要

  1. 每行最多只允許填寫1個圖片名稱。若同一個ProductId，對應多個PicName則需要填寫多行。

  2. 圖片名稱必須填寫后綴，例如：girl_cloth.jpg，不能寫為girl_cloth，必須寫為girl_cloth.jpg，否則會處理失敗。

  3. 如果圖片具有相同的商品ID+圖片名稱，則以最后一次添加為準。即如果圖片具有相同的商品ID+圖片名稱，則不管圖片本身是否相同，后一張圖片都會覆蓋前一張圖片。

  4. 新增圖片具體要求如下

    • 圖片大小要求不超過4 MB。

    • 圖片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。

    • 傳輸等待時間不超過5秒。

    • 服務類型為商品圖片搜索、通用圖片搜索、家具家居圖片搜索、工業五金圖片搜索時，圖片長和寬像素要求大于等于100且小于等于4096px。

    • 服務類型為商標圖片搜索時，圖片長和寬像素要求大于等于200且小于等于4096px。

    • 服務類型為布料圖片搜索時，圖片長和寬像素要求大于等于448且小于等于4096px。

    • 圖片中不能包含旋轉信息。

CategoryId

Integer

否

更多說明，請參見類目參考。

  • 對于商品搜索，如果設置類目，則以設置的為準，并且設置的類目必須在類目參考的范圍之內，否則會入庫失敗。

  • 如果不設置類目，將由系統進行類目預測，預測的類目結果可在Response中獲取。

  • 對于布料、商標、通用搜索、版權圖片搜索、工業五金、家具家居圖片搜索，不論是否設置類目，系統會將類目設置為88888888。

CustomContent

String

是

用戶自定義內容。最多支持4096個字符。

說明

圖片的CustomContent會在搜索結果中自動關聯出來。通過CustomContent字段，您可以填寫圖片的URL地址，圖片額外附加信息等，以便與您的業務關聯。

IntAttr

Integer

否

整數類型屬性。用于查詢時設置過濾。

說明

整型類型屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。

StrAttr

String

否

字符串類型屬性。最多支持128字符。用于查詢時設置過濾。

說明

字符串類型屬性與圖片查詢時的過濾條件組合使用，以起到過濾查詢的功能。請參考條件過濾。

Crop

Boolean

否

是否進行主體識別。默認為true。

  • true：系統自動進行主體識別，以識別的主體進行搜索。

  • false：不進行主體識別，以整張圖進行搜索。

說明

服務類型為布料圖片搜索、版權圖片搜索時，此參數不生效，默認以整張圖進行搜索。

Region

String

否

圖片的主體區域。格式為x1,x2,y1,y2，其中x1和y1是左上角的點，x2和y2是右下角的點。

說明

  • 若設置了該參數，則Crop參數不生效，以該設置為準。

  • 服務類型為布料圖片搜索、版權圖片搜索時，此參數不生效，默認以整張圖進行搜索。

步驟五：授予圖像搜索服務訪問OSS的權限

圖像搜索服務通過OSS來實現數據批量操作，首次使用需完成賬號一鍵授權。如已完成授權，可跳過此步驟。

步驟六：上傳圖片

  1. 登錄圖像搜索控制臺。

  2. 選擇目標服務類型和目標實例。

  3. 單擊批量操作頁簽。

    批量操作

  4. 單擊新建批量任務。

    p278660.png

  5. 設置批量任務參數。

    • 所屬區域

      實例所在區域。

    • Bucket名稱

      OSS上創建的相應的Bucket名稱。

      重要

      請確保開通的OSS服務以及創建的Bucket與已購買的圖像搜索服務在同一個地域。

    • 數據路徑

      需要上傳的圖片和increment.meta文件的存儲路徑。

      批量上傳.png

    • meta文件

      需要處理圖片的列表文件，支持檢測是否存在，文件名為increment.meta。

    • 完成后信息回調

      輸入回調地址，僅支持HTTP或者HTTPS開頭。

      {
  "finishTime": "2021-05-19 17:50:00",
  "instanceId": "imagesearch-cn-xxxx",
  "instanceName": "instanceName",
  "message": "success",
  "processResultUrl": "https://image-search-task-info.oss-cn-shanghai.aliyuncs.com/yyyyyyyyyy",
  "status": "NORMAL",
  "taskId": 111
}

      字段名

      描述

      finishTime

      完成時間，精確到秒。

      instanceName

      圖像搜索實例名稱。

      instanceId

      圖像搜索實例ID。

      status

      任務執行結果，NORMAL為正常，FAIL為執行失敗。

      taskId

      任務ID。

      message

      信息描述；success為成功。

      processResultUrl

      錯誤結果下載。

執行結果

任務運行完之后，您可以單擊實例ID查看任務運行的狀態。