SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Save an uploaded photo as a product photo, with the background removed

Upload the photo with POST /files first and pass its file_id. The product is cut out from its background so it sits cleanly in every template; send remove_background false to keep the photo as it is (for a place, a room or a dish). No AI credits are used. Errors: 400 file_id_required; 404 when the file is unknown or expired; 409 when the photo library is full; 413 image_too_large.

POSThttps://app.softsolz.uk/api/v1/services/creative-studio/assets

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

file_idstringrequired

From POST /files.

namestring

Photo name, for example "Coffee bag".

remove_backgroundboolean

Cut the product out (default true).

Response

Response Body

idstringPass as product_asset_id.
namestringPhoto name.
widthintegerWidth in pixels.
heightintegerHeight in pixels.
bytesintegerStored size.
background_removedbooleanTrue when the product was cut out.
created_atstringWhen it was added.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/creative-studio/assets \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"file_id": "f0000000-0000-0000-0000-000000000001",
"name": "Coffee bag"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 201

{
"data": {
"id": "your-id",
"name": "your-name",
"width": 1,
"height": 1,
"bytes": 1,
"background_removed": true,
"created_at": "2026-01-01T09:00:00.000Z"
}
}