Quickstart Guide

This guide will show you how to make your first successful call to the Firefly Text-to-Image API. Your organization admin must first create credentials in Adobe Developer Console and share the following information with you:

client_id
client_secret

To call the Firefly text-to-image endpoint, you need a valid API key and an access token. To get an access token, use the following command:

curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}&scope=openid,AdobeID,firefly_enterprise,firefly_api'
Copied to your clipboard
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}&scope=openid,AdobeID,firefly_enterprise,firefly_api'

Access tokens expire every 24 hours and it is wise that you rotate them programmatically before they expire. The token endpoint above returns expiry information alongside the token itself. Read more about this in our auth guide. Once you have this token, you are ready to make your first request to the text-to-image endpoint.

Now, replace your API key and access token in the example below, and you're all set to make your first request to the text-to-image endpoint.

Request Headers

X-Api-Key: This is a required parameter -- provide your client ID from Console.
Authorization: This is a required header -- provide your access token.
Content-Type: Specifies the media type of the request body.

Example Request

curl --location 'https://firefly-beta.adobe.io/v2/images/generate' \
--header 'X-Api-Key: {CLIENT_ID}' \
--header 'Authorization: {ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data '{
    "n": 1,
    "prompt": "Horse on a field.",
    "contentClass": "photo",
    "size": {
        "width": 2048,
        "height": 2048
    },
    "styles": {
        "presets": ["concept_art"]
    } 
}'
Copied to your clipboard
curl --location 'https://firefly-beta.adobe.io/v2/images/generate' \
--header 'X-Api-Key: {CLIENT_ID}' \
--header 'Authorization: {ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data '{
    "n": 1,
    "prompt": "Horse on a field.",
    "contentClass": "photo",
    "size": {
        "width": 2048,
        "height": 2048
    },
    "styles": {
        "presets": ["concept_art"]
    } 
}'

Responses

Got a 200 response code? Great! Your API call was successful. Here is an example response:

{
  "version": "2.10.2",
  "size": {
    "width": 2048,
    "height": 2048
  },
  "predictedPhotoSettings": {
    "aperture": 5.6,
    "shutterSpeed": 0.0005,
    "fieldOfView": 50
  },
  "outputs": [
    {
      "seed": 290878684,
      "image": {
          "id": "{IMAGE_ID}",
          "presignedUrl": "https://pre-signed-firefly-prod.s3.amazonaws.com/images/{IMAGE_ID}?..."
      }
    }
  ]
}
Copied to your clipboard
{
  "version": "2.10.2",
  "size": {
    "width": 2048,
    "height": 2048
  },
  "predictedPhotoSettings": {
    "aperture": 5.6,
    "shutterSpeed": 0.0005,
    "fieldOfView": 50
  },
  "outputs": [
    {
      "seed": 290878684,
      "image": {
          "id": "{IMAGE_ID}",
          "presignedUrl": "https://pre-signed-firefly-prod.s3.amazonaws.com/images/{IMAGE_ID}?..."
      }
    }
  ]
}

Horse on a field, photo, concept_art

Error Codes

To learn more about each response code, head over to the Try it (Responses) section.

Rate Limits

Read more about the text-to-image API's throttling limits here.

Try it yourself

Go ahead and try making calls using the Try it feature on the API Reference page. Configure the headers and send a request. Once you get a 200 response code, the response body will contain a pre-signed URL of your image.