Common Operations

Generate images with Image5

Changed on

Generate images asynchronously using Firefly's Image5 model. When <code>referenceBlobs</code> is included in the request, omit <code>aspectRatio</code> or set it to <code>auto</code>.

post/v4/images/generate-async

Request

  • Base URL: https://firefly-api.adobe.io
  • URL: https://firefly-api.adobe.io/v4/images/generate-async
  • Auth: API key in header x-api-key and HTTP bearer

Headers

x-model-version'image5' required

The model version to use for image generation.

Request body

promptstring required

The prompt used to generate the image. The longer the prompt, the better.

aspectRatio'1:1' | '4:3' | '3:4' | '16:9' | '9:16' | 'auto'
resolutionLevel'1MP' | '2.4MP' | '4MP'

The resolution level.

modelId'firefly_image'
numVariationsinteger

The number of image variations to generate. Greater than 1 is not supported. Only one image per variation is allowed. For multiple variations, send separate requests.

seedsinteger[]

The seed value to vary the image generation. Only one seed per variation is allowed. If specified alongside with numVariations, the number of seeds must be equal to numVariations.

Example request

{
  "modelSpecificPayload": {
    "localeCode": "en-US",
    "prompt_reasoner": "quality"
  }
}

Response

Success

linksobject required
progressnumber

Changes

  • 915646d1e240Revision changes
    • breaking

      removed the enum value 2MP of the request property

    • breaking

      removed the enum value auto of the request property

    • info

      the request property default value changed from auto to 2.4MP

    • info

      added the new 2.4MP enum value to the request property

  • 56fcaf9dc686Revision changes
    • info

      added the new optional request property

    • info

      added the new auto enum value to the request property