Last 7 days, UTC

Average Latency
123ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Query Authentication
 

API Key and Signature used for authentication


Authentication
Description
Parameter
String

API customer key. This is the key you've been given when creating your API account. Example Value: aaaa1111bbbb2222

api_key

Required

String

API call signature. The signature serve as simple and secure scheme to protect your call against spoofing and other identity thieft attacks. The signature is generated by hashing all current paramers and values and the API customer secret. More information about how to generate the signature can be found http://imagga.com/api/docs/how-to-generate-api-call-signature.html

sig

Required

Endpoints

HTTP 200 : string POST/uploadforprocessing.php
upload-image

Uploading image for processing


Test console
Description
Parameter
binary

file to be uploaded

file

Required

Smart Cropping

HTTP 200 : string GET/extractionrestserver.php
background-removal

An input digital image, defined by public image URL, is processed and the system returns an URL pointing to newly creating PNG image with an alpha channel that shows the suggested transparent regions (the removed background). Note: The result PNG images are deleted one hour after they've been created so you need to integrate a way to download them soon (or eventually immediately) after you receive their URLs as a response of the API.


Test console
Description
Parameter
string

Comma-separated list of (one or more) public image URLs to be processed for background removal. Example Value: http://78.128.78.162/test/sweater.jpg,http://78.128.78.162/test/top.jpg,http://78.128.78.162/test/dress.jpg
Example: http://78.128.78.162/test/sweater.jpg,http://78.128.78.162/test/top.jpg,http://78.128.78.162/test/dress.jpg

urls

Required

string

The API version number. Currenly always fixed to 1.0
Example: 1.0

v

Required

string

Example: imagga.process.backgroundremoval

method

Required

HTTP 200 : string POST/extractionrestserver.php
collage-slicing

An input digital image, defined by public image URL, is processed and any sub-images contained in it, if detected, are extracted as separate output images. Input images are expected to contain sub-images arranged as a collage and being separated by separation lines. If no sub-images are detected, the input image is returned as output image. Note: In all cases defined above, the output contains the coordinates defining each of the rectangular sub-images and NOT the sub-images raster data itself.


Test console
Description
Parameter
string

Comma-separated list of (one or more) public image URLs to be processed for slicing. Example Value: http://78.128.78.162/test/collage.jpg,http://78.128.78.162/test/dividing/1.jpg,http://78.128.78.162/test/dividing/3.jpg

urls

Required

string

The API version number. Currenly always fixed to 1.0
Example: 1.0

v

Required

string

Example: imagga.process.division

method

Required

HTTP 200 : string POST/extractionrestserver.php
smart-cropping

An input digital image defined by public image URL is analyzed. As a result of the analysis the API outputs one or several rectangular regions with predefined size(s), or size(s) with the same aspect ratio. The desired output sizes are given as input parameters by the API CUSTOMER together with the input digital image(s). The API tries to suggest appropriate cropping(s) in order to select some of the most informative and visually interesting parts of the input image, where possible. Note: The output contains the coordinates of what should be cropped, and NOT the sub-images raster data itself.


Test console
Description
Parameter
string

Comma-separated list of (one or more) public image URLs to be smart-cropped. Example Value: http://www.stockpodium.com/stock-photo-7890736/couple-child-spending-time-together-image.jpg,http://www.stockpodium.com/stock-photo-7314730/hand-keys-car-image.jpg

urls

Optional

string

Upload code generated after uploading image for processing, instead of providing URL. You can learn more about using upload for processing here. Example Value: 73f/1365268432-951977319.png

upload_code

Optional

string

This parameter is only meaningful if combined with upload_code. If its value is 1 the image that has been uploaded will be deleted after the processing task. Otherwise the image associated with the corresponding upload code will be available for other processings in the next one hour. Example Value: 1

delete_afterwards

Optional

string

Comma-separated list of (one or more) width and height pairs defining the target size (the size that the images should be resized to). If this parameter is omitted the system will suggest croppings that cover the main parts of what is considered visually interesting in the given images. Example Value (that will suggest three croppings, 150x200, 100x50, and 75x75, for earch of the input images): 150,200,100,50,75,75

resolutions

Optional

string

If this paramter is provided and its value is1 the system will keep strictly to the specified resolutions and not only to their aspect ratios. Otherwise, if this parameter is omitted or if its value is 0, the system actually suggests the maximum rectangle with the same aspect ratio as the required resolution, so that the API user will practically get a combination of cropping and thumbnailing at the same time. Default Value: 0

no_scaling

Optional

string

The API version number. Currenly always fixed to 1.0
Example: 1.0

v

Required

string

Example: imagga.process.crop

method

Required

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like Imagga Smart Cropping.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.