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.
https://app.softsolz.uk/api/v1/services/creative-studio/assetsRecent Requests
Kept only in this browserHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
file_idstringrequiredFrom POST /files.
namestringPhoto name, for example "Coffee bag".
remove_backgroundbooleanCut 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" }}