Adobe Core Workflow A — Firefly Services
Overview
Primary creative workflow using Adobe Firefly v3 APIs: text-to-image generation, generative fill (inpainting), and image expansion (outpainting). These are the most common Firefly Services operations for marketing asset automation.
Prerequisites
- Completed
adobe-install-auth with Firefly API scopes (firefly_api,ff_apis)
@adobe/firefly-apis installed, or direct REST access- Pre-signed cloud storage URLs for input/output images (S3, Azure Blob, or Dropbox)
Instructions
Step 1: Text-to-Image Generation (Synchronous)
import { getAccessToken } from '../adobe/client';
interface FireflyGenerateOptions {
prompt: string;
negativePrompt?: string;
width?: number;
height?: number;
n?: number;
contentClass?: 'art' | 'photo';
style?: {
presets?: string[];
strength?: number;
};
}
interface FireflyOutput {
outputs: Array<{
image: { url: string };
seed: number;
}>;
}
export async function generateImage(opts: FireflyGenerateOptions): Promise<FireflyOutput> {
const token = await getAccessToken();
const body: Record<string, any> = {
prompt: opts.prompt,
n: opts.n || 1,
size: { width: opts.width || 1024, height: opts.height || 1024 },
contentClass: opts.contentClass || 'photo',
};
if (opts.negativePrompt) body.negativePrompt = opts.negativePrompt;
if (opts.style?.presets) {
body.styles = { presets: opts.style.presets };
}
const response = await fetch('https://firefly-api.adobe.io/v3/images/generate', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'x-api-key': process.env.ADOBE_CLIENT_ID!,
'Content-Type': 'application/json',
},
body: JSON.stringify(body),
});
if (!response.ok) {
const err = await response.text();
throw new Error(`Firefly generate failed (${response.status}): ${err}`);
}
return response.json();
}
Step 2: Async Generation (for High Volume)
export async function generateImageAsync(opts: FireflyGenerateOptions) {
const token = await getAccessToken();
const response = await fetch('https://firefly-api.adobe.io/v3/images/generate-async', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'x-api-key': process.env.ADOBE_CLIENT_ID!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: opts.prompt,
n: opts.n || 1,
size: { width: opts.width || 1024, height: opts.height || 1024 },
}),
});
const { jobId, statusUrl, cancelUrl } = await response.json();
console.log(`Firefly async job: ${jobId}`);
let : ;
() {
( (r, ));
poll = (statusUrl, {
: {
: ,
: process..!,
},
});
result = poll.();
(result. === || result. === ) ;
}
(result. === ) ();
result;
}
Step 3: Generative Fill (Inpainting)
export async function generativeFill(
imageUrl: string,
maskUrl: string,
prompt: string
): Promise<FireflyOutput> {
const token = await getAccessToken();
const response = await fetch('https://firefly-api.adobe.io/v3/images/fill', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'x-api-key': process.env.ADOBE_CLIENT_ID!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
image: { source: { url: imageUrl } },
mask: { source: { url: maskUrl } },
prompt,
n: 1,
}),
});
if (!response.ok) throw new Error(`Fill failed: ${response.status}`);
return response.();
}
Step 4: Image Expansion (Outpainting)
export async function expandImage(
imageUrl: string,
targetWidth: number,
targetHeight: number,
prompt?: string
): Promise<FireflyOutput> {
const token = await getAccessToken();
const response = await fetch('https://firefly-api.adobe.io/v3/images/expand', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'x-api-key': process.env.ADOBE_CLIENT_ID!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
image: { source: { url: imageUrl } },
size: { width: targetWidth, height: targetHeight },
...(prompt && { prompt }),
n: 1,
}),
});
if (!response.ok) throw new Error(`Expand failed: `);
response.();
}
Output
- AI-generated images from text prompts (sync or async)
- Inpainted regions via generative fill with mask
- Expanded/outpainted images to larger canvas sizes
- Temporary URLs for generated images (download within 24h)
Error Handling
| Error | Cause | Solution |
|---|
400 prompt rejected | Content policy violation | Remove trademarks, real people, or explicit content from prompt |
403 Forbidden | Missing firefly_api scope | Add Firefly API to Developer Console project |
413 Payload Too Large | Image too large for fill/expand | Resize input to max 4096x4096 |
429 Too Many Requests | Rate limited | Use async endpoint; honor Retry-After header |
500 Internal Server Error | Transient Firefly error | Retry with backoff; check status.adobe.com |
Resources
Next Steps
For PDF document workflows, see adobe-core-workflow-b.
