Smart Crop

1. Smart cropping with photo URL input

API:

Params:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

img_url = 'link_url_img'
width = 400
height = 600

response = requests.get(
  "https://cloud.computervision.com.vn/api/v2/smartcrop/crop_image?url=%s&width=%s&height=%s"
  % (img_url, width, height),
  auth = (api_key, api_secret)
)

print(response.json())

2. Smart cropping with image file input

API:

Params:

Body:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
img_path = '/path/to/your/image.jpg'
width = 400
height = 600

response = requests.post(
    "https://cloud.computervision.com.vn/api/v2/smartcrop/crop_image?width=%s&height=%s"
  % (width, height),
    auth=(api_key, api_secret),
    files={'img': open(img_path, 'rb')})

print(response.json())

3. Smart crop optimized for photos with one or more people, using photo URL input

API:

Params:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

img_url = 'link_url_img'
width = 400
height = 600

response = requests.get(
  "https://cloud.computervision.com.vn/api/v2/smartcrop/crop_person?url=%s&width=%s&height=%s"
  % (img_url, width, height),
  auth = (api_key, api_secret)
)

print(response.json())

4. Smart crop optimized for photos with one or more people, using image file input

API:

Params:

Body:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
img_path = '/path/to/your/image.jpg'
width = 400
height = 600

response = requests.post(
    "https://cloud.computervision.com.vn/api/v2/smartcrop/crop_person?width=%s&height=%s"
  % (width, height),
    auth=(api_key, api_secret),
    files={'img': open(img_path, 'rb')})

print(response.json())

5. Response

The response will be a JSON with the following format:

{
  "url": [xxxx], // Result image URL
  "errorCode": int,
  "errorMessage": string,
  "invalidCode": int, // Only for crop_person
  "invalidMessage": string // Only for crop_person
}

Error code table:

Warning error code table: