Package: turing-api
Turing Python LibraryTuring visual search and visually similar recommendations API library for python. The REST API documentation can be found here:https://api.turingiq.com/doc/SetupThis package is available through pip and can be install using following command.pip3 install turing-apiInitializeimport thevisualAPIclass as bellow.fromturing_api.lib.visualAPIimportVisualAPIYou can initialize theVisualAPIclass with below parameters.api_key='your_api_key'# You can get API key when you login at: https://www.turingiq.com/loginmode='live'# the mode can be either `live` or `sandbox`. Default mode is `live`.visual_api=VisualAPI(api_key,mode)AutocropDetect objects in image and get bounding boxes around objects detected.# image_url is required field.image_url="https://example.com/image_url.jpg"# now let's call the API.response=visual_api.autocrop(image_url)The bounding boxes returned by this method can be given to visual search to improve visual search quality.InsertYou need to insert images to our index to query on them. The insert function can be written as below.# id is required field.id='some_product_id'# image_url is required field.image_url="https://example.com/image_url.jpg"# filters argument is optional. You can specify upto 3 filters as per example given below.# Filters can be useful when querying images from our index. You can apply any filter# as per your requirement.filters={"filter1":"onefilter","filter2":"twofilter","filter3":"threefilter"}# metadata is optional. You can pass additional information about your image which will be# returned when you query image from our index.metadata={"title":"Image Title"}# now let's call the API.response=visual_api.insert(id,image_url,filters,metadata)UpdateIf you need to update information to indexed image, you can use update function. If you call update function for id which is not already indexed, it will insert the image to index.# id is required field. Provide id for which you need to update the information.id='some_product_id'# image_url is optional field. You can pass `null` if you would like to keep URL unchanged.image_url="https://example.com/image_url.jpg"# filters argument is optional. You can specify upto 3 filters as per example given below.# Filters can be useful when querying images from our index. You can apply any filter# as per your requirement. The filters you provide here will be overwritten.filters={"filter1":"onefilter","filter2":"twofilter","filter3":"threefilter"}# metadata is optional. You can pass additional information about your image which will be# returned when you query image from our index. Existing metadata values will be overwritten# based on keys supplied to this array.metadata={"title":"Image Title"}# now let's call the API.response=visual_api.update(id,image_url,filters,metadata)DeleteYou can delete image from index with this method.# id is required field.id='some_product_id'# now let's call the API.response=visual_api.delete(id)Visual SearchVisual search can be used to search indexed images based on query image.# image_url is required field. The API will perform visual search on the image and returnimage_url="https://example.com/image_url.jpg"# crop_box is optional field. You can supply empty array if you don't want to specify crop box.# The format of crop box is [xmin, ymin, xmax, ymax]crop_box=[188,256,656,928]# filters argument is optional. You can specify upto 3 filters.# For example, if you specify filter1 = "nike", it will only return images which are indexed with# "nike" as filter1.filters={"filter1":"nike"}# now let's call the API.response=visual_api.search(image_url,crop_box,filters)Visual RecommendationsVisual recommendations give visually similar image recommendations which can be used to display recommendation widget on e-commerce sites which greatly improved CTR and conversion rates.# image_url is required field. The API will perform visual search on the image and returnid="some_product_id"# filters argument is optional. You can specify upto 3 filters.# For example, if you specify filter1 = "nike", it will only return images which are indexed with# "nike" as filter1.filters={"filter1":"nike"}# now let's call the API.response=visual_api.recommendations(id,filters)Run TestsAPI_KEY=api_keypython3test/visualAPITest.py