Adobe Suite

Adobe Suite Common Operations API

Core Firefly API operations for generating and manipulating images and videos.

Documentation GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v3/images/generate-async Generate images from a text prompt · Generate images #

Ask an LLM

“How do I generate images from a text prompt with Firefly?”

“Can I give a reference image so the results mimic its colors and layout?”

Tell an agent

Generate images of {prompt}.

Generate {numVariations} images of {prompt} without {negativePrompt}.

POST /v4/images/generate-async Generate images with the Image5 model · Generate images with Image5 #

Ask an LLM

“Can I generate images with the newer Firefly Image5 model?”

“What aspect ratio should I use with Image5 when I include reference images?”

Tell an agent

Use Image5 to generate {prompt}.

Generate {prompt} with Image5 at aspect ratio {aspectRatio}.

POST /v3/images/generate-similar-async Generate images similar to a reference · Generate similar images #

Ask an LLM

“Can I get variations that look like an image I already have?”

“How many similar images can I ask for from one reference?”

Tell an agent

Generate images similar to {image}.

Make {numVariations} look-alike variations of {image}.

POST /v3/images/expand-async Expand an image to a new size or ratio · Expand image #

Ask an LLM

“How do I extend an image beyond its borders to change its aspect ratio?”

“Can I describe what should fill the expanded area?”

Tell an agent

Expand {image} to size {size}.

Outpaint {image} and fill the new area with {prompt}.

POST /v3/images/fill-async Fill a masked area of an image · Fill image #

Ask an LLM

“How do I replace part of an image using a mask and a prompt?”

“What does the mask control when filling an image?”

Tell an agent

Fill the area of {image} under mask {mask}.

Fill the masked region {mask} of {image} with {prompt}.

POST /v3/videos/generate Generate a short video from a prompt · Generate video #

Ask an LLM

“Can Firefly make a five second video from a text prompt?”

“Is it possible to start a generated video from an image?”

Tell an agent

Generate a five second video of {prompt}.

Make a short video of {prompt} starting from image {image}.

GET /v3/custom-models List a user's custom models · Retrieve custom models #

Ask an LLM

“Which custom models do I have available for generation?”

“Can I filter my custom models by published state?”

Tell an agent

List my custom models.

Show my custom models that are {publishedState}, sorted by {sortBy}.

POST /v2/storage/image Upload a source image or mask · Upload image #

Ask an LLM

“How do I upload an image to use in fill, expand or upscale?”

“What do I get back after uploading a mask or source image?”

Tell an agent

Upload this image so I can use it in a fill.

Store my mask file and give me its upload ID.

Documentation

https://developer.adobe.com/photoshop/api/docs/

https://developer.adobe.com/developer-console/docs/guides/authentication/

https://developer.adobe.com/lightroom/api/docs/

https://developer.adobe.com/illustrator/api/docs/

https://developer.adobe.com/indesign/docs/

https://developer.adobe.com/document-services/docs/overview/pdf-services-api/

https://developer.adobe.com/document-services/docs/overview/pdf-extract-api/

https://developer.adobe.com/document-services/docs/overview/pdf-extract-api/gettingstarted/

https://developer.adobe.com/document-services/docs/overview/pdf-accessibility-auto-tag-api/

https://developer.adobe.com/analytics-apis/docs/

https://developer.adobe.com/analytics-apis/docs/2.0/

https://developer.adobe.com/firefly-services/docs/

https://developer.adobe.com/firefly-services/docs/api/

https://developer.adobe.com/audio-video-firefly-services/

https://developer.adobe.com/audio-video-firefly-services/getting-started/

https://developer.adobe.com/creative-cloud-libraries/docs/

https://developer.adobe.com/creative-cloud-libraries/docs/api/

https://developer.adobe.com/express/embed-sdk/docs/guides/

https://developer.adobe.com/express/embed-sdk/docs/v4/

https://developer.adobe.com/express/embed-sdk/docs/guides/quickstart/

https://developer.adobe.com/experience-platform-apis/

https://experienceleague.adobe.com/en/docs/experience-platform/landing/platform-apis/api-guide

https://developer.adobe.com/marketo-apis/

https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/authentication

https://developer.adobe.com/commerce/docs/

https://developer.adobe.com/commerce/webapi/get-started/

https://developer.adobe.com/experience-cloud/cloud-manager/

https://developer.adobe.com/journey-optimizer-apis/

https://developer.adobe.com/workfront-apis/

https://developer.adobe.com/firefly-services/docs/substance3d/

https://developer.adobe.com/data-collection-apis/

https://developer.adobe.com/adobe-status/

https://developer.adobe.com/vip-marketplace/

Specifications

https://raw.githubusercontent.com/api-evangelist/adobe-suite/refs/heads/main/openapi/adobe-suite-common-operations-api-openapi.yml

Other Resources

https://developer.adobe.com/document-services/pricing/

https://developer.adobe.com/document-services/docs/overview/pdf-services-api/sdks/

https://developer.adobe.com/document-services/docs/overview/pdf-services-api/releasenotes

https://developer.adobe.com/analytics-apis/docs/2.0/guides/

https://developer.adobe.com/firefly-services/docs/guides/

https://developer.adobe.com/audio-video-firefly-services/getting_started/usage/

https://developer.adobe.com/creative-cloud-libraries/docs/overview/

Integration Guide

https://developer.adobe.com/creative-cloud-libraries/docs/integrate/

API Fundamentals

https://experienceleague.adobe.com/en/docs/experience-platform/landing/platform-apis/api-fundamentals

Developer Guide

https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/home

https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/rest-api

https://developer.adobe.com/commerce/webapi/rest/

https://developer.adobe.com/commerce/webapi/graphql-api/

REST API Reference

https://developer.adobe.com/commerce/webapi/reference/rest/paas/

https://raw.githubusercontent.com/api-evangelist/adobe-suite/refs/heads/main/graphql/adobe-suite-graphql.md

https://developer.adobe.com/experience-cloud/cloud-manager/guides/getting-started/create-event-integration/

https://status.adobe.com/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/adobe-suite:adobe-suite-common-operations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  version: 3.0.0
  title: Firefly Common Operations API
  description: REST API for Adobe Firefly services including image generation, image alteration, image upscaling, video generation, and other related services.
servers:
- url: https://firefly-api.adobe.io
  description: Production server.
security:
- X-Api-Key: []
  AccessToken: []
tags:


# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adobe-suite/refs/heads/main/openapi/adobe-suite-common-operations-api-openapi.yml