Photo Enhancer

Get API Key

Photo Enhancer works on low quality photos which have bad focus, low resolution, blurry or pixelated effect, and damage. Every photo can be turned into HD ones with sharp focus.

API Mode 1 : Return binary stream

Sample Code

bash

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
  -F 'file=@/path/to/file.jpg'     \
  -f 'https://www.cutout.pro/api/v1/photoEnhance' \
  -o out.png

python

  import requests
  response = requests.post(
  	'https://www.cutout.pro/api/v1/photoEnhance',
  	files={'file': open('/path/to/file.jpg', 'rb')},
  	headers={'APIKEY': 'INSERT_YOUR_API_KEY_HERE'},
  )
  with open('out.png', 'wb') as out:
  	out.write(response.content)

php

  $client = new GuzzleHttp\Client();
  $res = $client->post('https://www.cutout.pro/api/v1/photoEnhance', [
  	'multipart' => [
  		[
  			'name'     => 'file',
  			'contents' => fopen('/path/to/file.jpg', 'r')
  		]
  	],
  	'headers' => [
  		'APIKEY' => 'INSERT_YOUR_API_KEY_HERE'
  	]
  ]);

  $fp = fopen("out.png", "wb");
  fwrite($fp, $res->getBody());
  fclose($fp);

java

  File file = new File("/Your/Image/File/Path");
  
  CloseableHttpClient client = HttpClients.createDefault();
  
  HttpPost httpPost = new HttpPost("https://www.cutout.pro/api/v1/photoEnhance");
  httpPost.setHeader("APIKEY", "INSERT_YOUR_API_KEY_HERE");
  
  MultipartEntityBuilder multipartEntityBuilder = MultipartEntityBuilder.create();
  multipartEntityBuilder.addBinaryBody("file", file);
  httpPost.setEntity(multipartEntityBuilder.build());
  
  try (CloseableHttpResponse response = client.execute(httpPost)){
  	if (response.getStatusLine().getStatusCode() == HttpStatusCode.OK) {
  		//save to local storage
  		byte[] bytes = EntityUtils.toByteArray(response.getEntity());
  		FileOutputStream outputStream = new FileOutputStream("/Image/File/Path");
  		outputStream.write(bytes);
  	}
  } catch (IOException e) {
  	e.printStackTrace();
  }

nodejs

  var request = require('request');
  var fs = require('fs');

  request.post({
    url: 'https://www.cutout.pro/api/v1/photoEnhance',
    formData: {
  	file: fs.createReadStream('/path/to/file.jpg')
    },
    headers: {
  	'APIKEY': 'INSERT_YOUR_API_KEY_HERE'
    },
    encoding: null
  }, function(error, response, body) {
    // console.log(response);
  });

.net

  using (var client = new HttpClient())
  using (var formData = new MultipartFormDataContent())
  {
  	formData.Headers.Add("APIKEY", "INSERT_YOUR_API_KEY_HERE");
  	formData.Add(new ByteArrayContent(File.ReadAllBytes("/path/to/file.jpg")), "file", "file.jpg");
  	var response = client.PostAsync("https://www.cutout.pro/api/v1/photoEnhance", formData).Result;
  	if(response.IsSuccessStatusCode) {
  		//todo: Handle your logic
  	} else {
  		//todo: Handle your logic
  	}
  }

objective-c

  NSURL *fileUrl = [NSBundle.mainBundle URLForResource:@"file" withExtension:@"jpg"];
  NSData *data = [NSData dataWithContentsOfURL:fileUrl];
  if (!data) {
  	return;
  }

  AFHTTPSessionManager *manager =
  [[AFHTTPSessionManager alloc] initWithSessionConfiguration:
   NSURLSessionConfiguration.defaultSessionConfiguration];

  manager.responseSerializer = [AFImageResponseSerializer serializer];
  [manager.requestSerializer setValue:@"INSERT_YOUR_API_KEY_HERE"
  				 forHTTPHeaderField:@"APIKEY"];

  NSURLSessionDataTask *dataTask = [manager
  	  POST:@"https://www.cutout.pro/api/v1/photoEnhance"
  	  parameters:nil
  	  constructingBodyWithBlock:^(id  _Nonnull formData) {
  		  [formData appendPartWithFileData:data
  									  name:@"file"
  								  fileName:@"file.jpg"
  								  mimeType:@"image/jpeg"];
  	  }
  	  progress:nil
  	  success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
  		  // Handle your logic
  	  } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
  		  // Handle your logic
  	  }];

  [dataTask resume];

API documentation

Photo Enhancer API helps to unblur image and enlarge image without losing quality in single click.

Request description

Request URL: https://www.cutout.pro/api/v1/photoEnhance
Request method: POST
Return type: PNG image
Content-Type: multipart/form-data

Input parameters:

(1) Request parameters (Header)

Parameter	Parameter Type	Description
APIKEY	string	Your API Key

Get API Key

(2) Request parameters (Body)

Parameter	Description	Required
file	Picture file	Yes

(3) Request parameters (query string)

Parameter	Description	Required
outputFormat	The output image format, which can be: png, webp, jpg_$quality($quality is the quality used to compress the image, the value is between 0 and 100, for example: jpg_75) the default value is: png	No

Response description

Normal return Return to HD image, in binary format and the content-type is image/png.
Error return if any error occurs, the response will be in json format.

{
  "code": 1001, //
  "data": null
  "msg": 'Insufficient balance',
  "time": 1590462453264
}

API Mode 2: Return base64 encoded string

Sample Code

bash

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
  -F 'file=@/path/to/file.jpg'     \
  -f 'https://www.cutout.pro/api/v1/photoEnhance2' \
  -o out.png

python

  import requests
  response = requests.post(
  	'https://www.cutout.pro/api/v1/photoEnhance2',
  	files={'file': open('/path/to/file.jpg', 'rb')},
  	headers={'APIKEY': 'INSERT_YOUR_API_KEY_HERE'},
  )

php

  $client = new GuzzleHttp\Client();
  $res = $client->post('https://www.cutout.pro/api/v1/photoEnhance2', [
  	'multipart' => [
  		[
  			'name'     => 'file',
  			'contents' => fopen('/path/to/file.jpg', 'r')
  		]
  	],
  	'headers' => [
  		'APIKEY' => 'INSERT_YOUR_API_KEY_HERE'
  	]
  ]);

java

  File file = new File("/Your/Image/File/Path");
  
  CloseableHttpClient client = HttpClients.createDefault();
  
  HttpPost httpPost = new HttpPost("https://www.cutout.pro/api/v1/photoEnhance2");
  httpPost.setHeader("APIKEY", "INSERT_YOUR_API_KEY_HERE");
  
  MultipartEntityBuilder multipartEntityBuilder = MultipartEntityBuilder.create();
  multipartEntityBuilder.addBinaryBody("file", file);
  httpPost.setEntity(multipartEntityBuilder.build());
  
  CloseableHttpResponse response = client.execute(httpPost);

nodejs

  var request = require('request');
  var fs = require('fs');

  request.post({
    url: 'https://www.cutout.pro/api/v1/photoEnhance2',
    formData: {
  	file: fs.createReadStream('/path/to/file.jpg')
    },
    headers: {
  	'APIKEY': 'INSERT_YOUR_API_KEY_HERE'
    },
    encoding: null
  }, function(error, response, body) {
    // console.log(response);
  });

.net

  using (var client = new HttpClient())
  using (var formData = new MultipartFormDataContent())
  {
  	formData.Headers.Add("APIKEY", "INSERT_YOUR_API_KEY_HERE");
  	formData.Add(new ByteArrayContent(File.ReadAllBytes("/path/to/file.jpg")), "file", "file.jpg");
  	var response = client.PostAsync("https://www.cutout.pro/api/v1/photoEnhance2", formData).Result;
  	if(response.IsSuccessStatusCode) {
  		//todo: Handle your logic
  	} else {
  		//todo: Handle your logic
  	}
  }

objective-c

  NSURL *fileUrl = [NSBundle.mainBundle URLForResource:@"file" withExtension:@"jpg"];
  NSData *data = [NSData dataWithContentsOfURL:fileUrl];
  if (!data) {
  	return;
  }

  AFHTTPSessionManager *manager =
  [[AFHTTPSessionManager alloc] initWithSessionConfiguration:
   NSURLSessionConfiguration.defaultSessionConfiguration];

  manager.responseSerializer = [AFJSONResponseSerializer serializer];
  [manager.requestSerializer setValue:@"INSERT_YOUR_API_KEY_HERE"
  				 forHTTPHeaderField:@"APIKEY"];

  NSURLSessionDataTask *dataTask = [manager
  	  POST:@"https://www.cutout.pro/api/v1/photoEnhance2"
  	  parameters:nil
  	  constructingBodyWithBlock:^(id  _Nonnull formData) {
  		  [formData appendPartWithFileData:data
  									  name:@"file"
  								  fileName:@"file.jpg"
  								  mimeType:@"image/jpeg"];
  	  }
  	  progress:nil
  	  success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
  		  // Handle your logic
  	  } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
  		  // Handle your logic
  	  }];

  [dataTask resume];

API documentation

Photo Enhancer API helps to unblur image and enlarge image without losing quality in single click.

Request description

Request URL: https://www.cutout.pro/api/v1/photoEnhance2
Request method: POST
Return type: PNG image
Content-Type: multipart/form-data

Input parameters:

(1) Request parameters (Header)

Parameter	Parameter Type	Description
APIKEY	string	Your API Key

Get API Key

(2) Request parameters (Body)

Parameter	Description	Required
file	Picture file	Yes

(3) Request parameters (query string)

Parameter	Description	Required
outputFormat	The output image format, which can be: png, webp, jpg_$quality($quality is the quality used to compress the image, the value is between 0 and 100, for example: jpg_75) the default value is: png	No

Response description

Normal return

{
    "code": 0,
    "data": {
		"imageBase: "iVBORw0KGgo..." //Base64 encoded string of the high-definition image
    },
    "msg": null,
    "time": 1590462453264
}

Error return if any error occurs, the response will be in json format.

{
  "code": 1001, //
  "data": null
  "msg": 'Insufficient balance',
  "time": 1590462453264
}

API Mode 3: Return base64 encoded via image URL

Sample Code

bash

  curl -X GET --header 'Accept: application/json' \
  --header 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
  'https://www.cutout.pro/api/v1/photoEnhanceByUrl?url=https%3A%2F%2Fd38b044pevnwc9.cloudfront.net%2Fcutout-nuxt%2Fenhancer%2F1-large-change.jpg'

API documentation

Photo Enhancer API helps to unblur image and enlarge image without losing quality in single click.

Request description

Request URL: https://www.cutout.pro/api/v1/photoEnhanceByUrl
Request method: GET
Content-Type: multipart/form-data

Input parameters:

(1) Request parameters (Header)

Parameter	Parameter Type	Description
APIKEY	string	Your API Key

Get API Key

(2) Request parameters (query string)

Parameter	Description	Required
url	The URL of the source picture	Yes
outputFormat	The output image format, which can be: png, webp, jpg_$quality($quality is the quality used to compress the image, the value is between 0 and 100, for example: jpg_75) the default value is: png	No

Response description

Normal return

{
    "code": 0,
    "data": {
		"imageBase: "iVBORw0KGgo..." //Base64 encoded string of the high-definition image
    },
    "msg": null,
    "time": 1590462453264
}

Error return if any error occurs, the response will be in json format.

{
  "code": 1001, //
  "data": null
  "msg": 'Insufficient balance',
  "time": 1590462453264
}

Frequently asked questions

Q: What are the requirements for the input image format?
A: Support PNG, JPG, JPEG, BMP, WEBP
Q: Is there a limit to the supported image size?
A: The maximum resolution uploaded at present is 4096x4096 pixels, and the image file size is less than 15MB
Q: Request QPS limit?
A: Supports 5 simultaneous requests per second

Photo Enhancer ​

API Mode 1 : Return binary stream ​

Sample Code ​

API documentation ​

Request description ​

Response description ​

API Mode 2: Return base64 encoded string ​

Sample Code ​

API documentation ​

Request description ​

Response description ​

API Mode 3: Return base64 encoded via image URL ​

Sample Code ​

API documentation ​

Request description ​

Response description ​

Frequently asked questions ​

Photo Enhancer

API Mode 1 : Return binary stream

Sample Code

API documentation

Request description

Response description

API Mode 2: Return base64 encoded string

Sample Code

API documentation

Request description

Response description

API Mode 3: Return base64 encoded via image URL

Sample Code

API documentation

Request description

Response description

Frequently asked questions