Composite Operations

Generate adaptive composite

Changed on

Submits an asynchronous adaptive composite generation job using the adaptive composite pipeline.

post/v3/images/adaptive-composite

Request

  • Base URL: https://firefly-api.adobe.io
  • URL: https://firefly-api.adobe.io/v3/images/adaptive-composite
  • Auth: API key in header x-api-key and HTTP bearer

Headers

content-type'application/json' required

Must be application/json for JSON request body.

Request body

numVariationsinteger

Number of output variations to generate.

seedsinteger[]

Array of seed image IDs. These reference images help ensure consistent image generation across multiple API calls. If specified alongside numVariations, the number of seeds must equal numVariations. Defaults: 1 variation → [333], 2 → [333, 222], 3 → [333, 222, 111].

harmonizationnumber float

Controls how much the object's colors and lighting are adjusted to match the background scene.

shadowIntensitynumber float

Controls shadow intensity in the composited result. Lower values reduce shadow.

preserveBackgroundboolean

When true, preserves original background details within the masked area during compositing.

Response

Accepted

statusstring

Current status of the job.

jobIdstring

Job URN identifier.

statusUrlstring uri

URL to poll for job status.

cancelUrlstring uri

URL to cancel the job.

Example response

{
  "status": "running"
}

Changes

  • 8bb5f0c4193fRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 9f9e7e4a32e8Revision changes
    • info

      api tag Common Operations removed