Images

Enhance product image

Enhance a single product image using AI.

How it works:

  1. Submit product image (URL or base64)
  2. AI processes the image synchronously
  3. Returns the enhanced image as an S3 URL, or a base64 data URL if requested

Return formats:

  • URL: Upload to S3 and return the output URL. Returned when you omit options, or set options.returnFormat: "url".
  • Base64: Return a base64 data URL. Set options.returnFormat: "base64". If you send options without returnFormat, it defaults to base64.

Default processing (when no prompt is supplied):

  • Preserve product colours, logos, text, texture and shape
  • Replace the background with pure white and remove hangers, mannequins and props
  • Apply even studio-style lighting and gently sharpen edges
  • Centre the product with balanced padding
  • Review the result before using it in a listing

Use cases:

  • Prepare images for marketplace listings
  • Create professional product photos
  • Standardize image quality across catalog

For background removal without the enhancement step, use POST /v1/images/remove-background. Processing duration varies; inspect the response and review the resulting image.

post/v1/images/enhance

Request

  • Base URL
    https://api.shopfront.app
  • Auth
    HTTP bearer

Request body

promptstring

Optional custom enhancement prompt (defaults to standard e-commerce enhancement)

Example request

{
  "prompt": "Enhance this vintage jacket photo. Remove background, improve lighting, but preserve the worn/vintage aesthetic."
}

Response

Image successfully enhanced

successboolean required

Whether enhancement succeeded

originalUrlstring required

Original image URL

enhancedUrlstring

Enhanced image as an S3 URL, or a base64 data URL when options.returnFormat is base64

processingTimeinteger

Processing time in milliseconds

errorstring nullable

Error message if enhancement failed

Example response

{
  "originalUrl": "https://i.ebayimg.com/images/g/abc/product.jpg",
  "enhancedUrl": "https://shopfront-s3-image-upload.s3.ap-southeast-2.amazonaws.com/api-enhanced/<orgId>/product_enh_v1_a3f9c2.png",
  "s3Location": {
    "bucket": "shopfront-s3-image-upload",
    "key": "api-enhanced/<orgId>/product_enh_v1_a3f9c2.png"
  },
  "processingTime": 3420,
  "error": "Failed to download image from URL"
}

Changes

No recorded changes to this operation across all 1 revision of this API.