Firefly Composite API for product photos vs Sume reference edit

Firefly Composite Operations blend a product photo into a generated scene. On Sume, send the photo as an input reference, with an optional mask_url.

4 min readSume
All posts

Firefly's Composite Operations APIs (Object Composite, Adaptive Composite and Precise Composite) blend a product shot into a generated scene. Sume has no composite endpoint in its image docs. The closest path is POST /v1/images with the product photo in input_references, a prompt describing the scene, and on ChatGPT Image 2.5 an optional mask_url.

Adobe facts are from its API overview; Sume facts from the Image API docs, read 2026-10-01.

What do the Firefly composite APIs offer?

Adobe describes uploading an image such as a product photo and using a text prompt to generate a composited scene. Precise Composite adds harmonization strength from 0 to 100 percent for lighting and shadows. Adaptive Composite can place products into existing or custom-generated backgrounds and adjusts object rotation to the scene.

What does the Sume path look like?

Both ChatGPT Image 2.5 variants support text-to-image, up to 16 image references and an optional mask_url. The docs describe mask_url as an optional public HTTPS mask URL for ChatGPT Image 2.5 edits. Reference URLs must be public HTTPS.

Product-in-scene controls from the Adobe and Sume docs, read 2026-10-01.
ControlFirefly compositesSume images
Product inputUploaded product imageinput_references (up to 16 on ChatGPT Image 2.5)
SceneText promptText prompt
Limit the edit areaNot covered on the page readOptional mask_url
Lighting harmonization setting0 to 100 percent on Precise CompositeNo such parameter in the docs

How do I keep the product unchanged?

Say so in the prompt and use a mask over the area that may change. The docs do not promise pixel-exact preservation, so inspect the result against your source. If you are choosing between models for packshots, this router post covers the options.

Which models accept a mask?

Only the ones that list it. The parameter table ties mask_url to ChatGPT Image 2.5 edits, and a parameter a model does not list is rejected with 400 unsupported_parameter. Check supported_parameters in the catalog first.

Sources

Related posts

More in Use cases

All Use cases posts

Written by Sume