Skip to content
eWiki The practical AI reference

AI Tool Glossary

Adobe Firefly Structure Reference: What It Is and How the Strength Control Works

Wireframe structure, translucent blue panels, and a white sculpted form arranged on a pale tabletop.

Adobe Firefly Structure Reference uses an existing image to guide the structure of generated images. Learn what the strength parameter controls and how Adobe documents the API workflow.

What Adobe Firefly Structure Reference Does

Adobe Firefly Structure Reference uses an existing image to guide the structural characteristics of newly generated images. Adobe’s API documentation identifies outline and depth as examples of those characteristics. The generated image can have details, styles, or moods that differ from the reference.

Adobe also describes the reference as a structural template for producing multiple variations with the same layout. Its announcement of the feature lists uses such as redesigning a room from a photograph or sketch, turning a drawing into another kind of image, colorizing line art, and changing the subject while retaining the structure.

A practical suggestion is to choose Structure Reference when layout, pose, outline, or depth is the characteristic you want to guide. That is an editorial recommendation based on Adobe’s description, not a guarantee that every generated variation will reproduce every structural detail.

Architectural drawings spread beneath a row of geometric blocks, cylinders, a blue sphere, and a metal ruler.

How the Strength Control Works in the Firefly Image APIs

In the Firefly Image APIs, structural guidance is supplied through a structure parameter. It contains two properties: strength, which determines how closely the generated image resembles the reference, and imageReference, which identifies the reference-image source.

Adobe documents strength as accepting values from 1 through 100. If the property is omitted, its default is 50. Adobe’s example begins with a value of 100 and directs developers to experiment with other values to observe how strength influences resemblance.

Adobe’s supplied documentation establishes this numeric control for the API. It does not map those numbers to named web-interface settings. Therefore, a suggested comparison method is to generate otherwise comparable variations at several supported values and inspect which result best serves the intended composition. Treat the preferred value as a creative choice rather than a documented universal setting.

A person's hands adjust a black circular device beside a wireframe cube, clear grid panel, and white block on a gray table.

Documented API Workflow

Adobe’s API example requires a Firefly Client ID and access token. Its documentation says these credentials should be stored securely and must not be exposed in client-side or public code.

The documented sequence is:

  1. Upload the reference image to the Firefly storage API.
  2. Read the returned images.id value and use it as the upload identifier.
  3. Submit an asynchronous image-generation request with a prompt and a structure object containing strength and imageReference.
  4. Use the returned jobId with the status endpoint to retrieve the result.

The worked request uses the prompt “a photo of a volcano,” a strength of 100, and four variations. Adobe explains that four result URLs are returned for that example. Developers should substitute their own authorized reference, prompt, credentials, and uploaded-image ID when adapting the request.

Structure Reference and Style Reference Serve Different Roles

Adobe documents Structure Reference and Style Reference as distinct forms of guidance. Structure Reference transfers structural characteristics from an existing image. Adobe’s feature announcement describes Style Reference as taking a style-reference image and applying it to the prompt.

Adobe says the two capabilities can be combined so that an image supplies both structural and stylistic guidance. A suggested decision rule is to start with Structure Reference when composition is the priority, use Style Reference when visual treatment is the priority, and consider both when both kinds of guidance are necessary. This is a workflow recommendation; Adobe’s excerpts do not establish that combining them will produce a particular result.

Conclusion

Adobe Firefly Structure Reference is a documented way to guide generated images with the outline, depth, and layout of an existing image while allowing other characteristics to differ. In the Firefly Image APIs, the strength parameter ranges from 1 to 100, defaults to 50 when omitted, and controls resemblance to the reference.

For practical use, the recommended approach is to select a reference whose structure clearly expresses the intended composition, keep the prompt focused on the desired new subject or treatment, and compare several supported strength values. Choose the result and value that best fit the project rather than treating one strength as correct for every image. For implementation, follow Adobe’s documented upload, generation, and status-check sequence, and keep API credentials out of public or client-side code.

Sources

Disclosure

This article was prepared with AI assistance.

Improve this guide

Report a problem or suggest the next question

Submissions enter a private editorial queue. They are reviewed and deduplicated before any public update or new page is created.