接口列表

準備工作

• 在安裝和使用阿里云SDK前，確保您已經注冊阿里云賬號并生成訪問密鑰（AccessKey）。詳情請參見創建AccessKey。

• 使用如下方式安裝依賴包。

pip install alibabacloud_imagesearch20201214

Add接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import AddImageAdvanceRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  def addImage():
      request = AddImageAdvanceRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = '<instanceName>'
      # 必填，商品id，最多支持 512個字符。
      # 一個商品可有多張圖片。
      request.product_id = '<productId>'
      # 必填，圖片名稱，最多支持 512個字符。
      # 1. ProductId + PicName唯一確定一張圖片。
      # 2. 如果多次添加圖片具有相同的ProductId + PicName，以最后一次添加為準，前面添加的圖片將被覆蓋。
      request.pic_name = '<picName>'
      # 圖片內容，最多支持 4MB大小圖片以及5s的傳輸等待時間。當前僅支持PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM格式圖片；
      # 對于商品、商標、通用圖片搜索，圖片長和寬的像素必須都大于等于100且小于等于4096；
      # 對于布料搜索，圖片長和寬的像素必須都大于等于448且小于等于4096；
      # 圖像中不能帶有旋轉信息；
  
      # 使用URL方式釋放下方注釋即可。   
      # url = '<fileUrl>'    
      # f = BytesIO(requests.get(url).content)  
  
      # 使用圖片file新增
      f = open('<filePath>', 'rb')
  
      request.pic_content_object = f
      # 選填，商品類目。
      # 1. 對于商品搜索：若設置類目，則以設置的為準；若不設置類目，將由系統進行類目預測，預測的類目結果可在Response中獲取 。
      # 2. 對于布料、商標、通用搜索：不論是否設置類目，系統會將類目設置為88888888。
      request.category_id = 3
      # 選填，用戶自定義的內容，最多支持4096個字符。
      # 查詢時會返回該字段。例如可添加圖片的描述等文本。
      request.custom_content = "this is a simple test"
      # 選填，整數類型屬性，可用于查詢時過濾，查詢時會返回該字段。
      #  例如不同的站點的圖片/不同用戶的圖片，可以設置不同的IntAttr，查詢時通過過濾來達到隔離的目的
      request.int_attr = 56
      # 選填，字符串類型屬性，最多支持 128個字符。可用于查詢時過濾，查詢時會返回該字段。
      request.str_attr = "test"
      # 選填，是否需要進行主體識別，默認為true。
      # 1.為true時，由系統進行主體識別，以識別的主體進行搜索，主體識別結果可在Response中獲取。
      # 2.為false時，則不進行主體識別，以整張圖進行搜索。
      # 3.對于布料圖片搜索，此參數會被忽略，系統會以整張圖進行搜索。
      request.crop = True
      # 選填，圖片的主體區域，格式為 x1,x2,y1,y2, 其中 x1,y1 是左上角的點，x2，y2是右下角的點。設置的region 區域不要超過圖片的邊界。
      # 若用戶設置了Region，則不論Crop參數為何值，都將以用戶輸入Region進行搜索。
      # 對于布料圖片搜索，此參數會被忽略，系統會以整張圖進行搜索。
      request.region = "167,467,221,407"
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.[regionId].aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.[regionId].aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'   
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
      runtime_option = RuntimeOptions()
      response = client.add_image_advance(request, runtime_option)
      print(response.to_map())
      f.close()
  if __name__ == '__main__':
      addImage()

• 結果示例

  {
    'RequestId': '7F769FFC-4F45-476E-BE6C-E4EF82E012A7',
    'Success': True,
    'Message': 'success',
    'Code': 0,
    'PicInfo': {
      'CategoryId': 20,
      'Region': '474,747,497,784'
    }
  }

SearchImageByPic接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import SearchImageByPicAdvanceRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  def searchImageByPic() :
      request = SearchImageByPicAdvanceRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = '<instanceName>'
      # 圖片內容，最多支持 4MB大小圖片以及5s的傳輸等待時間。當前僅支持PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM格式圖片；
      # 對于商品、商標、通用圖片搜索，圖片長和寬的像素必須都大于等于100且小于等于4096；
      # 對于布料搜索，圖片長和寬的像素必須都大于等于448且小于等于4096；
      # 圖像中不能帶有旋轉信息
  
      # 使用URL方式釋放下方注釋即可。   
      # url = '<fileUrl>'    
      # f = BytesIO(requests.get(url).content)  
  
      # 使用圖片file 查詢相似圖片
      f = open('<filePath>', 'rb')
  
      request.pic_content_object = f
      # 選填，商品類目。
      # 1. 對于商品搜索：若設置類目，則以設置的為準；若不設置類目，將由系統進行類目預測，預測的類目結果可在Response中獲取 。
      # 2. 對于布料、商標、通用搜索：不論是否設置類目，系統會將類目設置為88888888。
      request.category_id = 3
      # 選填，返回結果的數目。取值范圍：1-100。默認值：10。
      request.num = 10
      # 選填，返回結果的起始位置。取值范圍：0-499。默認值：0。
      request.start = 0
      # 選填，是否需要進行主體識別，默認為true。
      # 1.為true時，由系統進行主體識別，以識別的主體進行搜索，主體識別結果可在Response中獲取。
      # 2.為false時，則不進行主體識別，以整張圖進行搜索。
      # 3.對于布料圖片搜索，此參數會被忽略，系統會以整張圖進行搜索。
      request.crop = True
      # 選填，圖片的主體區域，格式為 x1,x2,y1,y2, 其中 x1,y1 是左上角的點，x2，y2是右下角的點。設置的region 區域不要超過圖片的邊界。
      # 若用戶設置了Region，則不論Crop參數為何值，都將以用戶輸入Region進行搜索。
      # 3.對于布料圖片搜索，此參數會被忽略，系統會以整張圖進行搜索。
      request.region="167,467,221,407"
      # 選填，過濾條件
      # int_attr支持的操作符有>、>=、<、<=、=，str_attr支持的操作符有=和!=，多個條件之支持AND和OR進行連接。
      # 示例：
      #  1. 根據IntAttr過濾結果，int_attr>=100
      #  2. 根據StrAttr過濾結果，str_attr!="value1"
      #  3. 根據IntAttr和StrAttr聯合過濾結果，int_attr=1000 AND str_attr="value1"
      request.filter="int_attr=56 AND str_attr=\"test\""
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
      runtime_option = RuntimeOptions()
      response = client.search_image_by_pic_advance(request, runtime_option)
      print(response.to_map())
      f.close()
  if __name__ == '__main__':
      searchImageByPic()

• 結果示例

  {
    'RequestId': '53C481F3-E064-428D-AB25-B6C57A704E68',
    'Success': True,
    'Code': 0,
    'Msg': 'success',
    'Auctions': [{
      'CategoryId': 20,
      'ProductId': 'test-version-001',
      'PicName': 'test-version-001.jpg',
      'CustomContent': None,
      'Score': 1.0
      'SortExprValues': '5.37633353624177e+24;0',
      'IntAttr': None,
      'StrAttr': None
    }, {
      'CategoryId': 20,
      'ProductId': 'test_0426_1',
      'PicName': 'test_0426_1.png',
      'CustomContent': None,
      'Score': 1.0,
      'SortExprValues': '2.71303606033325;263',
      'IntAttr': None,
      'StrAttr': None
    }],
    'Head': {
      'DocsReturn': 5,
      'DocsFound': 5,
      'SearchTime': 295
    },
    'PicInfo': {
      'CategoryId': 20,
      'Region': '474,747,497,784',
      'AllCategories': [{
        'Id': 0,
        'Name': 'Tops'
      }, {
        'Id': 1,
        'Name': 'Dress'
      }, {
        'Id': 2,
        'Name': 'Bottoms'
      }, {
        'Id': 3,
        'Name': 'Bag'
      }, {
        'Id': 4,
        'Name': 'Shoes'
      }, {
        'Id': 5,
        'Name': 'Accessories'
      }, {
        'Id': 6,
        'Name': 'Snack'
      }, {
        'Id': 7,
        'Name': 'Makeup'
      }, {
        'Id': 8,
        'Name': 'Bottle'
      }, {
        'Id': 9,
        'Name': 'Furniture'
      }, {
        'Id': 20,
        'Name': 'Toy'
      }, {
        'Id': 21,
        'Name': 'Underwear'
      }, {
        'Id': 22,
        'Name': 'Digital device'
      }, {
        'Id': 88888888,
        'Name': 'Other'
      }],
      'MultiRegion': [{
          'Region': '112,440,76,387'
       }]
    }
  }

SearchImageByName接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import SearchImageByNameRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  def searchImageByName() :
      request = SearchImageByNameRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = '<instanceName>'
      # 必填，商品id，最多支持 512個字符。
      # 一個商品可有多張圖片。
      request.product_id = '<productId>'
      # 必填，圖片名稱，最多支持 512個字符。
      # 1. ProductId + PicName唯一確定一張圖片。
      # 2. 如果多次添加圖片具有相同的ProductId + PicName，以最后一次添加為準，前面添加的圖片將被覆蓋。
      request.pic_name = '<picName>'
      # 選填，商品類目。
      # 1. 對于商品搜索：若設置類目，則以設置的為準；若不設置類目，將由系統進行類目預測，預測的類目結果可在Response中獲取 。
      # 2. 對于布料、商標、通用搜索：不論是否設置類目，系統會將類目設置為88888888。
      request.category_id = 3
      # 選填，返回結果的數目。取值范圍：1-100。默認值：10。
      request.num = 10
      # 選填，返回結果的起始位置。取值范圍：0-499。默認值：0。
      request.start = 0
      # 選填，是否需要進行主體識別，默認為true。
      # 1.為true時，由系統進行主體識別，以識別的主體進行搜索，主體識別結果可在Response中獲取。
      # 2.為false時，則不進行主體識別，以整張圖進行搜索。
      # 3.對于布料圖片搜索，此參數會被忽略，系統會以整張圖進行搜索。
      request.crop = True
      # 選填，圖片的主體區域，格式為 x1,x2,y1,y2, 其中 x1,y1 是左上角的點，x2，y2是右下角的點。設置的region 區域不要超過圖片的邊界。
      # 若用戶設置了Region，則不論Crop參數為何值，都將以用戶輸入Region進行搜索。
      # 3.對于布料圖片搜索，此參數會被忽略，系統會以整張圖進行搜索。
      request.region="167,467,221,407"
      # 選填，過濾條件
      # int_attr支持的操作符有>、>=、<、<=、=，str_attr支持的操作符有=和!=，多個條件之支持AND和OR進行連接。
      # 示例：
      #  1. 根據IntAttr過濾結果，int_attr>=100
      #  2. 根據StrAttr過濾結果，str_attr!="value1"
      #  3. 根據IntAttr和StrAttr聯合過濾結果，int_attr=1000 AND str_attr="value1"
      request.filter="int_attr=56 AND str_attr=\"test\""
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
      response = client.search_image_by_name(request)
      print(response.to_map())
  if __name__ == '__main__':
      searchImageByName()

• 結果示例

  {
    'RequestId': '7BC00158-3B9B-49C4-9E25-FFEC28AF3CE8',
    'Success': True,
    'Code': 0,
    'Msg': 'success',
    'Auctions': [{
      'CategoryId': 20,
      'ProductId': 'test-version-001',
      'PicName': 'test-version-001.jpg',
      'CustomContent': None,
      'score':1.0,
      'SortExprValues': '5.37633353624177e+24;0',
      'IntAttr': None,
      'StrAttr': None
    }, {
      'CategoryId': 20,
      'ProductId': 'test_0426_1',
      'PicName': 'test_0426_1.png',
      'CustomContent': None,
      'score':1.0,
      'SortExprValues': '2.71303606033325;263',
      'IntAttr': None,
      'StrAttr': None
    }],
    'Head': {
      'DocsReturn': 5,
      'DocsFound': 5,
      'SearchTime': 15
    },
    'PicInfo': {
      'CategoryId': 20,
      'Region': None,
      'AllCategories': [{
        'Id': 0,
        'Name': 'Tops'
      }, {
        'Id': 1,
        'Name': 'Dress'
      }, {
        'Id': 2,
        'Name': 'Bottoms'
      }, {
        'Id': 3,
        'Name': 'Bag'
      }, {
        'Id': 4,
        'Name': 'Shoes'
      }, {
        'Id': 5,
        'Name': 'Accessories'
      }, {
        'Id': 6,
        'Name': 'Snack'
      }, {
        'Id': 7,
        'Name': 'Makeup'
      }, {
        'Id': 8,
        'Name': 'Bottle'
      }, {
        'Id': 9,
        'Name': 'Furniture'
      }, {
        'Id': 20,
        'Name': 'Toy'
      }, {
        'Id': 21,
        'Name': 'Underwear'
      }, {
        'Id': 22,
        'Name': 'Digital device'
      }, {
        'Id': 88888888,
        'Name': 'Other'
      }],
      'MultiRegion': [{
          'Region': '112,440,76,387'
       }]
    }
  }

Delete接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import DeleteImageRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  def deleteImage() :
      request = DeleteImageRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = '<instanceName>'
      # 必填，商品id，最多支持 512個字符。
      # 一個商品可有多張圖片。
      request.product_id = '<productId>'
      # 必填，圖片名稱，最多支持 512個字符。
      # 1. ProductId + PicName唯一確定一張圖片。
      # 2. 如果多次添加圖片具有相同的ProductId + PicName，以最后一次添加為準，前面添加的圖片將被覆蓋。
      request.pic_name = '<picName>'
      config = Config()
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      config.type = 'access_key'
      client = Client(config)
      response = client.delete_image(request)
      print(response.to_map())
  if __name__ == '__main__':
      deleteImage()

• 結果示例

  {
    'RequestId': '9ADA959B-B639-4B3B-841D-2399F1C34DA8',
    'Success': True,
    'Message': 'success',
    'Code': 0
  }

UpdateImage接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import UpdateImageRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  def updateImage() :
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
  
      request = UpdateImageRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = "xxxxxx"
      # 必填，商品ID 不可修改。
      request.product_id = "1"
      # 必填，圖片名稱，不可修改。
      request.pic_name = "1"
      # 選填，整數類型屬性，可用于查詢時過濾，查詢時會返回該字段。
      request.int_attr = "1"
      # 選填，字符串類型屬性，最多支持 128個字符。可用于查詢時過濾，查詢時會返回該字段。
      request.str_attr = "test"
      # 選填，用戶自定義的內容，最多支持4096個字符。
      request.custom_content = "這是一個測試說明"
      response = client.update_image(request)
      print(response.body.to_map())
  
  if __name__ == '__main__':
      updateImage()

• 結果示例

  {'Code': 0, 'RequestId': '864F581A-F2F8-1AF8-B1EA-1EFBF177E9F9', 'Success': True}

Detail接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import DetailRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  def detail() :
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
  
      request = DetailRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = "xxxxxx"
      response = client.detail(request)
      print(response.body.to_map())
  
  if __name__ == '__main__':
      detail()

• 結果示例

  {
    'Instance': {
      'Capacity': 10,
      'Name': 'xxxxx',
      'Qps': 1,
      'Region': 'cn-shanghai',
      'ServiceType': 0,
      'TotalCount': 99999,
      'UtcCreate': 1620382716000,
      'UtcExpireTime': 1623081600000
    },
    'RequestId': '1BEEACA0-A4C9-1B83-93A6-3005BB769B4E',
    'Success': True
  }

DumpMeta接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import DumpMetaRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  def dumpMeta() :
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
  
      request = DumpMetaRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = "xxxxxx"
      response = client.dump_meta(request)
      print(response.body.to_map())
  
  if __name__ == '__main__':
      dumpMeta()

• 結果示例

  {
    'Data': {
      'DumpMetaStatus': 'PROCESSING',
      'Id': 570
    },
    'RequestId': '5F70A624-D90D-1CDE-9549-542D97B68329',
    'Success': True
  }

DumpMetaList接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import DumpMetaListRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  def dumpMetaList() :
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
  
      request = DumpMetaListRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = "xxxxxx"
      # 選填，元數據導出任務id 。
      request.id = 567
      # 選填，返回結果起始位置，默認1 。
      request.page_number = 1
      # 選填，返回結果數量，默認20 。
      request.page_size = 1
      response = client.dump_meta_list(request)
      print(response.body.to_map())
  
  if __name__ == '__main__':
      dumpMetaList()

• 結果示例

  {
    'Data': {
      'DumpMetaList': [
        {
          'Code': '0',
          'Id': 567,
          'MetaUrl': 'https://xxx/xx/xx',
          'Msg': 'success',
          'Status': 'SUCCESS',
          'UtcCreate': 1639969113000,
          'UtcModified': 1639969140000
        }
      ],
      'PageNumber': 1,
      'PageSize': 1,
      'TotalCount': 1
    },
    'RequestId': '8B2B472B-72EC-1BE5-98F2-780BCBE67F82'
  }

BatchTask接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import IncreaseInstanceRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  def batchTask() :
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
  
      request = IncreaseInstanceRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = "xxxxxx"
      # 必填，oss 中 bucket名稱。
      request.bucket_name = "bucketName"
      # 必填，路徑，必須 / 開頭, 非 / 結尾。
      # 此路徑下需要提前準備好 increment.meta 文件，可參考，用戶指南下的批量操作文檔。
      request.path = "/public/xxx"
      # 選填，請求成功回調地址，http(s):// 。
      request.callback_address = "http://xxx/xxx"
      response = client.increase_instance(request)
      print(response.body.to_map())
  
  if __name__ == '__main__':
      batchTask()

• 結果示例

  {
    'Data': {
      'Id': 472,
      'IncrementStatus': 'PROCESSING'
    },
    'RequestId': '5D4391D4-54EA-14CD-B616-F23BDE4ECAA3',
    'Success': True
  }

BatchTaskList接口

• 代碼示例

  from alibabacloud_imagesearch20201214.client import Client
  from alibabacloud_imagesearch20201214.models import IncreaseListRequest
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  def batchTaskList() :
      config = Config()
      # 創建AK/SK參考：http://bestwisewords.com/document_detail/116401.htm
      # 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
      # 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
      # 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
      config.access_key_id = os.environ['CC_AK_ENV']
      config.access_key_secret = os.environ['CC_SK_ENV']
      # 請更換成您購買實例的區域，例如購買的是杭州區域，則endpoint='imagesearch.cn-hangzhou.aliyuncs.com'
      config.endpoint = 'imagesearch.<regionId>.aliyuncs.com'
  
      # 以下為內網（VPC）訪問方式
      # 說明：內網（VPC）訪問：僅限同區域ECS或資源的訪問，例如您購買的圖像搜索實例是華東2（上海），那么您的ECS或資源也必須在華東2（上海）才能通過內網VPC地址訪問圖搜服務，否則會調用不通，如果遇到調用不通，請先檢查您的ECS或資源與圖像搜索是否在同一個區域。
      # config.endpointType = 'internal'  // 如果是內網訪問圖像搜索服務，則endpointType為必填項，值統一為'internal'
      # config.endpoint = 'imagesearch-vpc.<regionId>.aliyuncs.com' // 為內網訪問（VPC）地址，請您更換為您購買實例的區域，例如您購買實例的區域為杭州，則endpoint='imagesearch-vpc.cn-hangzhou.aliyuncs.com'
  
      # 請您更換成您購買實例的區域，例如您購買的實例區域為杭州，則更換為regionId='cn-hangzhou'
      config.region_id = '<regionId>'
      config.type = 'access_key'
      client = Client(config)
  
      request = IncreaseListRequest()
      # 必填，圖像搜索實例名稱。注意是實例名稱不是實例ID。購買后通過上云層管控臺實例信息一欄查看：https://imagesearch.console.aliyun.com/overview
      request.instance_name = "xxxxxx"
      # 選填，任務id。
      request.id = 567
      # 選填，查詢oss 的 BucketName。
      request.bucket_name = "BucketName"
      # 選填，查詢oss 的 path 路徑。
      request.path = "/localization/xxxx"
      # 選填，返回結果起始位置，默認1。
      request.page_number = 1
      # 選填，返回結果數量，默認20。
      request.page_size = 1
      response = client.increase_list(request)
      print(response.body.to_map())
  
  if __name__ == '__main__':
      batchTaskList()

• 結果示例

  {
    'Data': {
      'Increments': {
        'Instance': [
          {
            'BucketName': 'xxxxx',
            'Code': '0',
            'ErrorUrl': 'https://ccx/xx/',
            'Id': 567,
            'Msg': 'success',
            'Path': '/public/xx',
            'Status': 'NORMAL',
            'UtcCreate': 1639107872000,
            'UtcModified': 1639125540000
          }
        ]
      },
      'PageNumber': 1,
      'PageSize': 1,
      'TotalCount': 1
    },
    'RequestId': 'C02F0C44-E61F-1E96-870C-CBE19E137ADF'
  }