@musallam/ffs-firefly-client

JavaScript/TypeScript client for the Adobe Firefly API.

Generate images from text prompts, expand or fill images with AI-generated content, and create videos using Adobe Firefly models.

Installation

npm install @musallam/ffs-firefly-client ky

ky is a peer dependency (^1.0.0); install a compatible 1.x version alongside this package. Releases that bundled ky internally are a previous major line—when upgrading, ensure ky is listed in your app if your package manager does not add it automatically.

Authentication

Obtain a Bearer token and API key from the Adobe Developer Console.

The package exports a singleton client with baseUrl pre-configured. Set auth once at app startup:

import { client } from '@musallam/ffs-firefly-client';

client.setConfig({
  auth: () => 'YOUR_ACCESS_TOKEN',
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});

Interceptors

Use client.interceptors to handle token refresh, logging, or errors:

import { client } from '@musallam/ffs-firefly-client';

// Refresh token before each request
client.interceptors.request.use((request) => {
  request.headers.set('Authorization', `Bearer ${getAccessToken()}`);
  return request;
});

// Log responses
client.interceptors.response.use((response) => {
  console.log(`${response.status} ${response.url}`);
  return response;
});

// Eject when no longer needed
const id = client.interceptors.request.use(myInterceptor);
client.interceptors.request.eject(id);

Usage

Flat (tree-shakeable)

import { createClient, createConfig } from '@musallam/ffs-firefly-client';
import {
  generateImagesV3Async,
  expandImagesV3Async,
  fillImagesV3Async,
} from '@musallam/ffs-firefly-client';

createClient(
  createConfig({
    baseUrl: 'https://firefly-api.adobe.io',
    headers: {
      Authorization: 'Bearer YOUR_ACCESS_TOKEN',
      'x-api-key': 'YOUR_API_KEY',
    },
  })
);

const result = await generateImagesV3Async({ body: { prompt: 'a cat on a surfboard' } });

Class-based

import { createClient, createConfig, FireflySdk } from '@musallam/ffs-firefly-client/sdk';

const client = createClient(
  createConfig({
    baseUrl: 'https://firefly-api.adobe.io',
    headers: {
      Authorization: 'Bearer YOUR_ACCESS_TOKEN',
      'x-api-key': 'YOUR_API_KEY',
    },
  })
);
const firefly = new FireflySdk(client);

const result = await firefly.generateImagesV3Async({ body: { prompt: 'a cat on a surfboard' } });