ÃÛ¶¹ÊÓƵ

DocumentationWorkfrontÃÛ¶¹ÊÓƵ Workfront Fusion

ÃÛ¶¹ÊÓƵ Firefly modules

Last update: Thu Feb 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

In an ÃÛ¶¹ÊÓƵ Workfront Fusion scenario, you can automate workflows that use ÃÛ¶¹ÊÓƵ Firefly, as well as connect it to multiple third-party applications and services.

If you need instructions on creating a scenario, see the articles under Create a scenario: article index.

For information about modules, see the articles under Modules: article index.

Access requirements

Expand to view access requirements for the functionality in this article.

You must have the following access to use the functionality in this article:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
ÃÛ¶¹ÊÓƵ Workfront package Any
ÃÛ¶¹ÊÓƵ Workfront license

New: Standard

Or

Current: Work or higher
ÃÛ¶¹ÊÓƵ Workfront Fusion license**

Current: No Workfront Fusion license requirement.

Or

Legacy: Workfront Fusion for Work Automation and Integration
Product

New:

  • Select or Prime Workfront package: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses.

Prerequisites

Before you can use the ÃÛ¶¹ÊÓƵ Firefly connector, you must ensure that the following prerequisites are met:

  • You must have an active ÃÛ¶¹ÊÓƵ Firefly account.

ÃÛ¶¹ÊÓƵ Firefly API information

The ÃÛ¶¹ÊÓƵ Firefly connector uses the following:

API tag
v1.4.24

Create a connection to ÃÛ¶¹ÊÓƵ Firefly

To create a connection for your ÃÛ¶¹ÊÓƵ Firefly modules:

  1. Click Add next to the Connection box.

  2. Fill in the following fields:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    Connection name Enter a name for this connection.
    Environment Select whether you are connecting to a production or non-production environment.
    Type Select whether you are connecting to a service account or a personal account.
    Client ID Enter your ÃÛ¶¹ÊÓƵ Client ID. This can be found in the Credentials details section of the ÃÛ¶¹ÊÓƵ Developer Console.
    Client Secret Enter your ÃÛ¶¹ÊÓƵ Client Secret. This can be found in the Credentials details section of the ÃÛ¶¹ÊÓƵ Developer Console.

  3. Click Continue to save the connection and return to the module.

ÃÛ¶¹ÊÓƵ Firefly modules and their fields

When you configure ÃÛ¶¹ÊÓƵ Firefly modules, Workfront Fusion displays the fields listed below. Along with these, additional ÃÛ¶¹ÊÓƵ Firefly fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another.

Map toggle

Expand an image

This action module expands an image, optionally with content from a prompt you provide.

This module works with the Firefly API V3 Async. The previous version of this module has been deprecated and will be removed in the near future.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Campaign, see Create a connection to ÃÛ¶¹ÊÓƵ Firefly in this article.
Prompt
Enter or map a prompt for the content with which you want to expand the image. If no prompt is provided, the image will be expanded with content matching the original image.
Number of variations
Enter a number between 1-4. The module will generate this number of expanded image variations.
Source

Select how you are providing the source file:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Expanded image format
Select the file format that the expanded image will be saved as.
Expand by

Select whether you want to expand the image by using image placement or by using a mask.

  • Placement

    Enter the horizontal and vertial alignment, and the inset of the placed image from the edges.

  • Mask

    Select the source file for the mask, and whether the mask should be inverted.

Size
Select the height and width that you want the expanded image to be.
Seeds
For each image that the module will generate, click Add item and enter or map an integer. You can use this same seed in another Expand an image module to generate a similar image with different styles. The number of seeds you add must be equal to the Number of variations field.

Expand an image (deprecated)

This module has been deprecated and will be removed in the near future. Use the Expand an image module instead.

Fill an image

This action module fills the masked area of an image, optionally with content from a prompt you provide.

This module works with the Firefly API V3 Async. The previous version of this module has been deprecated and will be removed in the near future.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Campaign, see Create a connection to ÃÛ¶¹ÊÓƵ Firefly in this article.
Image > Source

Select how you are providing the image source file:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Mask > Source

Select how you are providing the mask source file:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Prompt
Enter or map a prompt for the content with which you want to fill the image. If no prompt is provided, the image will be filled with content matching the original image.
Number of variations
Enter a number between 1-4. The module will generate this number of filled image variations.
Filled image format
Select the file format that the filled image will be saved as.
Seeds
For each image that the module will generate, click Add item and enter or map an integer. You can use this same seed in another Expand an image module to generate a similar image with different styles. The number of seeds you add must be equal to the Number of variations field.
Size
Select the size that you want the filled image to be.
Locale

If a locale is provided, the module generates content more relevant to the specified locale.

Locale must be provided in ISO 639-1 language code and ISO 3166-1 region.

Example: en-US

Fill an image (deprecated)

This module has been deprecated and will be removed in the near future. Use the Fill an image module instead.

Generate an image

This action module generates and image based on a prompt you provide. You can also provide an optional reference image, and the generated image will match the style of the reference image.

This module works with the Firefly API V3 Async. The previous version of this module has been deprecated and will be removed in the near future.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Campaign, see Create a connection to ÃÛ¶¹ÊÓƵ Firefly in this article.
Prompt
Enter or map a prompt for the image you want to generate. More detail in the prompt will allow you more control over what appears in the image.
Number of variations
Enter a number between 1-4. The module will generate this number of image variations.
Generated image format
Select the file format that the expanded image will be saved as. If you select default, the file format will be JPEG if no reference image is provided. If a reference image is provided, the file format of the generated image will be the same as the reference image.
Structure > Image reference

Select how you are providing the source file for the new image's structure:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Structure > Strength
Enter a number between 0 and 100 to control how strictly Firefly follows the source image's structure. Higher numbers mean that Firefly follows the image more strictly.
Style > Image reference

Select how you are providing the source file for the new image's style:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Structure > Strength
Enter a number between 0 and 100 to control how strictly Firefly follows the source image's style. Higher numbers mean that Firefly follows the image more strictly.
Style > Presets

If you want to use a preset style, click Add item and enter or map the style that you want to use.

For a list of preset styles, see in the ÃÛ¶¹ÊÓƵ developer documentation.

Negative prompt
Enter or map the words that you want to avoid in the generated content.
Content class

Select whether you want the generated image to be more like a photo, or more like created art.

  • Photo

    Enter values for the Aperture, Shutter speed (in seconds), and field of view (in millimeters).

Seed
For each image that the module will generate, click Add item and enter or map an integer. You can use this same seed in another Expand an image module to generate a similar image with different styles. The number of seeds you add must be equal to the Number of variations field.
Size
Select the size that you want the generated image to be.
Visual intensity
Enter or map an integer that represents the overall intensity of the photo's existing visual characteristics.
Locale

If a locale is provided, the module generates content more relevant to the specified locale.

Locale must be provided in ISO 639-1 language code and ISO 3166-1 region.

Example: en-US

Tileable
Enable this option to generate an image that can be repeated infinitely in every direction.

Generate an image (deprecated)

This module has been deprecated and will be removed in the near future. Use the Generate an image module instead.

Generate an object composite

This action module combines images generated by Firefly to create an image composite.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Campaign, see Create a connection to ÃÛ¶¹ÊÓƵ Firefly in this article.
Prompt
Enter or map a prompt for the image you want to generate. More detail in the prompt will allow you more control over what appears in the image.
Number of variations
Enter a number between 1-4. The module will generate this number of image variations.
Content classs
Select whether you want the generated image to be more like a photo or like art.
Image > Source

Select how you are providing the source file for the new image's structure:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Generated image format
Select the file format that the expanded image will be saved as. If you select default, the file format will be JPEG if no reference image is provided. If a reference image is provided, the file format of the generated image will be the same as the reference image.
Style > Image reference

Select how you are providing the source file for the new image's style:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Structure > Strength
Enter a number between 0 and 100 to control how strictly Firefly follows the source image's style. Higher numbers mean that Firefly follows the image more strictly.
Style > Presets

If you want to use a preset style, click Add item and enter or map the style that you want to use.

For a list of preset styles, see in the ÃÛ¶¹ÊÓƵ developer documentation.

Size
Select the size that you want the generated composite to be.

Generate similar images

This action module generates images similar to the source image you specify.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Campaign, see Create a connection to ÃÛ¶¹ÊÓƵ Firefly in this article.
Number of variations
Enter a number between 1-4. The module will generate this number of image variations.
Generated image format
Select the file format that the expanded image will be saved as. If you select default, the file format will be JPEG if no reference image is provided. If a reference image is provided, the file format of the generated image will be the same as the reference image.
Image > Source

Select how you are providing the source file for the new image's structure:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Style > Image reference

Select how you are providing the source file for the new image's style:

  • File

    Select a source file from a previous module, or map the source file's Reference image file name and reference image file.

  • Presigned URL

    Enter or map the URL of the source image.

Size
Select the size that you want the generated composite to be.
Seeds
For each image that the module will generate, click Add item and enter or map an integer. You can use this same seed in another Expand an image module to generate a similar image with different styles. The number of seeds you add must be equal to the Number of variations field.
Tileable
Enable this option to generate an image that can be repeated infinitely in every direction.

Make a custom API call

This action module makes a custom call to the Firefly API.

For specific available APIs, see in the ÃÛ¶¹ÊÓƵ Developer documentation.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Firefly, see Create a connection to ÃÛ¶¹ÊÓƵ Firefly in this article.
URL
Enter a path relative to https://firefly-api.adobe.io/.
Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods.
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds authorization headers automatically.

Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3