Smart Crop

Thử nghiệm nhanh API:Run in Postman

1. Cắt ảnh thông minh với đầu vào URL ảnh

API:

MethodURL
GEThttps://cloud.computervision.com.vn/api/v2/smartcrop/crop_image

Params:

KeyValueMô tả
urlhttps://example.com/image.pngURL ảnh cần cắt
width400Chiều rộng của ảnh đầu ra
height600Chiều dài của ảnh đầu ra

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. Cắt ảnh thông minh với đầu vào file ảnh

API:

MethodURLcontent-type
POSThttps://cloud.computervision.com.vn/api/v2/smartcrop/crop_imagemultipart/form-data

Params:

KeyValueMô tả
width400Chiều rộng của ảnh đầu ra
height600Chiều dài của ảnh đầu ra

Body:

KeyTypeValueMô tả
imgfileexample.jpgFile ảnh cần cắt

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. Cắt ảnh thông minh tối ưu cho ảnh có một hoặc nhiều người, sử dụng đầu vào URL ảnh

API:

MethodURL
GEThttps://cloud.computervision.com.vn/api/v2/smartcrop/crop_person

Params:

KeyValueMô tả
urlhttps://example.com/image.pngURL ảnh cần cắt
width400Chiều rộng của ảnh đầu ra
height600Chiều dài của ảnh đầu ra

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. Cắt ảnh thông minh tối ưu cho ảnh có một hoặc nhiều người, sử dụng đầu vào file ảnh

API:

MethodURLcontent-type
POSThttps://cloud.computervision.com.vn/api/v2/smartcrop/crop_personmultipart/form-data

Params:

KeyValueMô tả
width400Chiều rộng của ảnh đầu ra
height600Chiều dài của ảnh đầu ra

Body:

KeyTypeValueMô tả
imgfileexample.jpgFile ảnh cần cắt

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. Thông tin trả về

Phản hồi sẽ là một JSON với định dạng sau:

{
"url": [xxxx], // URL ảnh kết quả
"errorCode": int, // Mã lỗi
"errorMessage": string, // Thông báo lỗi
"invalidCode": int, // Chỉ dùng cho crop_person, mã thông báo nếu mặt người trong ảnh bị che khuất
"invalidMessage": string // Chỉ dùng cho crop_person, thông báo nếu mặt người trong ảnh bị che khuất
}

Bảng mã lỗi:

Mã lỗiMessageMô tả
0SuccessThành công
1Incorrect image formatẢnh bị lỗi
2Url is unavailableLink ảnh bị lỗi
3The photo does not contain contentẢnh không chứa nội dung
4Incorrect api_key or api_secretKhi api_key hoặc api_secret sai
4Out of requestsHết số lượng request
6Error when processing the requestLỗi khi xử lý request

Bảng mã lỗi cảnh báo:

Mã lỗiMessageMô tả
0SuccessfulThành công
1The photo does not contain faceẢnh không chứa khuôn mặt
2Photo contains more than one faceẢnh chứa nhiều hơn một khuôn mặt
3Wearing sun glassesĐeo kính đen
4Wearing a hatĐội mũ
5Wearing a maskĐeo khẩu trang
6Tilt more than 15 degreesNghiêng quá 15 độ
7Photo taken from picture, screenẢnh chụp từ ảnh, màn hình
8The face in the picture is too smallMặt trong ảnh quá nhỏ