Skip to main content
Use this flow when your platform has one or more product photos and needs a cleaner ecommerce-ready result. Start with single_product_white_background and strict preservation for one-product catalog photos. 
curl -X POST https://aigenstudio.app/api/v1/product-image-enhancements \
  -H "Authorization: Bearer aigen_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: merchant-42-product-123-v1" \
  -d '{
    "preset": "single_product_white_background",
    "preservation_level": "strict",
    "images": [
      {
        "external_id": "product-123",
        "source_url": "https://cdn.example.com/products/product-123.jpg"
      }
    ]
  }'

​
Do not require per-product prompts

The API is designed so platform teams can send structured intent instead of writing a prompt for each product. Use:
  • preset for the visual outcome;
  • preservation_level for how conservative the edit should be;
  • external_id for catalog mapping;
  • instructions only for special product-specific exceptions.

​
Optional instructions

Use instructions when your workflow has a real exception: 
{
  "instructions": "Keep all four items in the bundle visible. Do not crop the logo."
}
Do not pass untrusted merchant text directly as instructions unless your product experience is designed for that.

​
Read the result

Poll the enhancement status endpoint or subscribe to webhooks. Completed items include: 
{
  "external_id": "product-123",
  "status": "completed",
  "result_url": "https://.../image.png",
  "thumbnail_url": "https://.../thumbnail.png"
}
Use external_id to update the matching product in your catalog.