Understanding Firefly API Seeds
Use seeds to generate images similar to one another across multiple HTTP requests
Whenever Firefly generates an image, by default it begins the process by picking a random seed. This random value contributes to what makes each image unique, which is great when you want to generate a wide variety of images
However, there may be times when you want to generate images that are similar to one another across multiple HTTP requests. For example, when Firefly generates an image that you want to modify using Firefly's other options (such as style presets, reference images, etc.), use that image's seed in future HTTP requests to limit the randomness of future images and hone in on the image you want.
If you don't already have a Firefly "client ID" and "access token", learn how to retrieve them in the Authentication Guide before reading further. Securely store these credentials and never expose them in client-side or public code.
First, open a secure terminal and export your "client ID" and "access token" as environment variables:
Copied to your clipboardexport FIREFLY_CLIENT_ID=asdf...123export FIREFLY_ACCESS_TOKEN=qwer...456
Next, run the following curl command to generate an image:
Copied to your clipboardcurl --location 'https://firefly-api.adobe.io/v3/images/generate' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--header "x-api-key: $FIREFLY_CLIENT_ID" \--header "Authorization: Bearer $FIREFLY_ACCESS_TOKEN" \--data '{"prompt": "a futuristic future cityscape with flying cars",}'
The above request will return a response like this:
Copied to your clipboard{"size": {"width": 2048,"height": 2048},"outputs": [{"seed": 1842533538,"image": {"url": "https://pre-signed-firefly-prod.s3-accelerate.amazonaws.com/images/asdf-1234..."}}],"contentClass": "photo"}
Let's generate similar variations of this image by using its seed of 1842533538 in our next request. This allows us to use all Firefly's other generation options such as style presets, size, reference images, and more, while keeping the more image consistent with this previously generated image that we like.
Below, let's generate an image variation has "landscape photography" and "science fiction" style presets applied to it.
Copied to your clipboardcurl --location 'https://firefly-api.adobe.io/v3/images/generate' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--header "x-api-key: $FIREFLY_CLIENT_ID" \--header "Authorization: Bearer $FIREFLY_ACCESS_TOKEN" \--data '{"prompt": "a futuristic future cityscape with flying cars","seeds": [1842533538],"style": {"presets": ["landscape_photography", "science_fiction"]}}'
Your response will look like this:
Copied to your clipboard{"size": {"width": 2048,"height": 2048},"outputs": [{"seed": 1842533538"image": {"url": "https://pre-signed-firefly-prod.s3-accelerate.amazonaws.com/images/dfgh-1234..."}}],"contentClass": "art"}
Notice how many similarities there are between these two images generated from the same seeds.
