Sada Files

Developer docs

  1. Developers
  2. Tool endpoints

Product Photo API

White or transparent background, auto-centre, soft shadow and marketplace presets — Amazon 2000×2000, Flipkart, Shopify, Etsy, Meesho.

Environment

EnvironmentBase URL
Productionhttps://api.sadafiles.com/v1

There is one environment and no sandbox, so every request here is real and counts toward your limits.

Request

POSThttps://api.sadafiles.com/v1/tools/product-photo
Content type
multipart/form-data
Auth
X-API-Key with tools:run
Accepts
jpg, png, webp, avif, gif, bmp, tiff, heic and 1 more
Files per request
1 to 500
Largest file
2 GB
Job timeout
600 s
Rate weight
20 units

Parameters

Send these as a JSON string in the options form field. Anything else is rejected.

NameTypeDefaultAllowed
marketplacestringamazon—
backgroundstringwhitewhite, transparent
shadowbooleantrue—
paddingPercentinteger8min 0, max 40, %

Response

StatusBodyWhen
201sameThe run finished within 60 seconds
202Job summary JSONStill running; poll the job
4xx, 5xxError JSONSee error codes

A file response carries X-Sada-Job and X-Sada-Expires-At. For long work, post to /v1/tools/product-photo/jobs instead. See jobs and webhooks.

Also runs on the device

In the web tool and apps, Product Photo can run locally with no upload. The API always processes on the server.

Ready settings

These settings power the matching pages on the site, and work the same in the API.

Useoptions
Amazon Product Photo (2000×2000, white){"marketplace":"amazon"}
Flipkart Product Photo{"marketplace":"flipkart"}
Meesho Product Photo{"marketplace":"meesho"}

Try it yourself!

Pick a file, set the options and run a real request with your key. The code follows your changes.

Headers

You need a free key to run this request. Sign in and create a key.

Body

curl -X POST "https://api.sadafiles.com/v1/tools/product-photo" \  -H "X-API-Key: $SADAFILES_API_KEY" \  -F "files[]=@input.jpg" \  -o output.same

What's next?