Common Operations

Generate similar images

Changed on Mar 24, 2026

Generate similar images based on a reference image that you provide as a parameter.

post/v3/images/generate-similar-async

Request

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

Headers

x-model-version'image3' | 'image4_standard' | 'image4_ultra'

Specify the Firefly model version to use for the image generation.

Request body

numVariationsinteger

Generate this number of variations. <code>numVariations</code> defaults to the number of seed images, or to 1 if you do not specify seeds.

seedsinteger[]

Array of seed image IDs. These reference images help ensure consistent image generation across multiple API calls. If specified along with <code>numVariations</code>, the number of seeds must equal <code>numVariations</code>.

Response

Accepted

cancelUrlstring required

The URL to cancel the job.

jobIdstring required

The ID of the job.

statusUrlstring required

The URL to check the status of the job.

Changes

Mar 24, 20268bb5f0c4193f Revision changes
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  added subschema #1 subschema #2 to the /// response property oneOf list for the response status
- warning
  removed the optional property from the response with the status
- warning
  added the new cai_assertion_violation_error enum value to the response property for the response status
- info
  removed subschema #1 subschema #2 from the /// response property anyOf list for the response status
- info
  removed the access_error enum value from the response property for the response status
- info
  removed the bad_request enum value from the response property for the response status
- info
  removed the empty_input_body enum value from the response property for the response status
- info
  removed the invalid_content_type enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  removed the runtime_error enum value from the response property for the response status
- info
  removed the timeout_error enum value from the response property for the response status
Mar 24, 20263739755cb321 Revision changes
- breaking
  added the new required request property (media type: multipart/form-data)
- breaking
  added the new required request property (media type: application/json)
- breaking
  added the new required request property (media type: multipart/form-data)
- breaking
  the request's body type changed from no type to object (media type: application/json)
- breaking
  the request's body type changed from no type to object (media type: multipart/form-data)
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- warning
  added the new access_error enum value to the response property for the response status
- warning
  added the new access_error enum value to the response property for the response status
- warning
  added the new access_error enum value to the response property for the response status
- warning
  added the new access_error enum value to the response property for the response status
- warning
  added the new access_error enum value to the response property for the response status
- warning
  added the new access_error enum value to the response property for the response status
- warning
  added the new access_error enum value to the response property for the response status
- warning
  added the new bad_request enum value to the response property for the response status
- warning
  added the new bad_request enum value to the response property for the response status
- warning
  added the new bad_request enum value to the response property for the response status
- warning
  added the new bad_request enum value to the response property for the response status
- warning
  added the new bad_request enum value to the response property for the response status
- warning
  added the new bad_request enum value to the response property for the response status
- warning
  added the new bad_request enum value to the response property for the response status
- warning
  added the new empty_input_body enum value to the response property for the response status
- warning
  added the new empty_input_body enum value to the response property for the response status
- warning
  added the new empty_input_body enum value to the response property for the response status
- warning
  added the new empty_input_body enum value to the response property for the response status
- warning
  added the new empty_input_body enum value to the response property for the response status
- warning
  added the new empty_input_body enum value to the response property for the response status
- warning
  added the new empty_input_body enum value to the response property for the response status
- warning
  added the new invalid_content_type enum value to the response property for the response status
- warning
  added the new invalid_content_type enum value to the response property for the response status
- warning
  added the new invalid_content_type enum value to the response property for the response status
- warning
  added the new invalid_content_type enum value to the response property for the response status
- warning
  added the new invalid_content_type enum value to the response property for the response status
- warning
  added the new invalid_content_type enum value to the response property for the response status
- warning
  added the new invalid_content_type enum value to the response property for the response status
- warning
  added the new rate_limited enum value to the response property for the response status
- warning
  added the new rate_limited enum value to the response property for the response status
- warning
  added the new rate_limited enum value to the response property for the response status
- warning
  added the new rate_limited enum value to the response property for the response status
- warning
  added the new rate_limited enum value to the response property for the response status
- warning
  added the new rate_limited enum value to the response property for the response status
- warning
  added the new rate_limited enum value to the response property for the response status
- warning
  added the new runtime_error enum value to the response property for the response status
- warning
  added the new runtime_error enum value to the response property for the response status
- warning
  added the new runtime_error enum value to the response property for the response status
- warning
  added the new runtime_error enum value to the response property for the response status
- warning
  added the new runtime_error enum value to the response property for the response status
- warning
  added the new runtime_error enum value to the response property for the response status
- warning
  added the new runtime_error enum value to the response property for the response status
- warning
  added the new timeout_error enum value to the response property for the response status
- warning
  added the new timeout_error enum value to the response property for the response status
- warning
  added the new timeout_error enum value to the response property for the response status
- warning
  added the new timeout_error enum value to the response property for the response status
- warning
  added the new timeout_error enum value to the response property for the response status
- warning
  added the new timeout_error enum value to the response property for the response status
- warning
  added the new timeout_error enum value to the response property for the response status
- warning
  added the new validation_error enum value to the response property for the response status
- warning
  added the new validation_error enum value to the response property for the response status
- warning
  added the new validation_error enum value to the response property for the response status
- warning
  added the new validation_error enum value to the response property for the response status
- warning
  added the new validation_error enum value to the response property for the response status
- warning
  added the new validation_error enum value to the response property for the response status
- warning
  added the new validation_error enum value to the response property for the response status
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: application/json)
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status

Operation history (12 revisions)