SocialMati
AI — image & videoOAuth server-to-server (Client ID + Client secret)Confirm pricing before publishing

Adobe Firefly Services

Commercially safe Firefly image generation.

AProvider definition

Provider
Adobe Firefly Services
What it does
Commercially safe Firefly image generation (enterprise Firefly Services credentials).
Why we need it
Commercially safe Firefly image generation.
Used in
Studio → Images
AI capabilities
image, video

BAccount requirements

Account type
Adobe enterprise organisation with Firefly Services entitlement
Prerequisites
  • Adobe Admin Console access
  • Firefly Services enabled for the org

CConnection method

Authentication
OAuth server-to-server (Client ID + Client secret)
Where to enter it
  • Your workspace: App → Integrations → Providers & API keysWorkspace owner or admin. Keys added here are used only by your workspace (AI keys here don't use plan credits).
  • Platform-wide (Super Admin): Super Admin → Platform → IntegrationsPlatform owner. Used for every customer who hasn't added their own key; can also be set as PLATFORM_KEY_<PROVIDER> on the API server.

Setup steps

  1. 1Sign in to the provider console and open Adobe Developer Console → your project → Firefly Services credential.
  2. 2Create a new API key. Give it a name such as “SocialMati production”.
  3. 3Copy the key immediately — most providers show it only once.
  4. 4Add billing or credits on the provider account if your plan needs it.
  5. 5Paste the key in the application (see “Where to enter it”), save, then click Test.

DPermissions & API scopes

Scopes are granted on the provider's side when you authorise the app.

This list is generated from the scopes the application's code requests.

EFree vs paid

Free account / free API access
No public free tier for Firefly Services.
Card or billing account required?
Enterprise agreement.
Paid plan / costs
Enterprise Firefly Services contract.
Quota and usage limits
Provider-specific rate limits.
Not yet verified. Confirm on the provider's official pricing page before publishing.

FSetup screenshots

Capture each step with real values masked. Save images as public/docs/integrations/adobe_firefly/1.png … 10.png and they appear here automatically.

  1. Screenshot to add
    1. Account login / creation
    The provider's sign-in or sign-up page.
  2. Screenshot to add
    2. Developer console
    The developer console or dashboard home.
  3. Screenshot to add
    3. Project / app creation
    Creating the app or project used for this integration.
  4. Screenshot to add
    4. API enablement
    The API or product enabled for the project.
  5. Screenshot to add
    5. OAuth configuration
    Consent screen / OAuth settings with the redirect URIs.
  6. Screenshot to add
    6. API key / credentials creation
    Creating the key, secret or token (mask the value).
  7. Screenshot to add
    7. Permissions / scopes
    The scopes or permissions requested or approved.
  8. Screenshot to add
    8. Billing / quota settings
    Billing, credits or quota page.
  9. Screenshot to add
    9. Application connection
    The provider card in our application with fields filled (secrets masked).
  10. Screenshot to add
    10. Successful connection
    The green Test result or the connected account listed.

GApplication configuration

Never include real API keys, client secrets, access tokens or passwords in screenshots, tickets or documentation. Values below are field names and examples only.

FieldRequiredExample / defaultNotes
Client IDYes—
Client secretYes••••••••Stored encrypted; shown masked after saving.

HTesting

  1. 1Click Test — it requests a Firefly Services access token.
  2. 2Generate a short piece of content in AI Studio with this provider's model selected (Model selector → choose a model from this provider).

ITroubleshooting

ProblemWhat to do
401 / invalid API keyThe key was revoked, mistyped or belongs to another project. Create a new key and paste it again.
402 / insufficient credits / quota exceededAdd credits or raise the spending limit on the provider account.
“No text model is available”The provider is switched off or limited to certain plans in Super Admin → AI Management, or its models are disabled. The error message names the cause.
Invalid credentialsCheck the Client ID/App ID and secret were copied from the same app, without spaces. Regenerate the secret if unsure.
Missing permissionsReconnect and accept every permission on the consent screen. If a permission is missing from the list, add it to the app (and get it approved).
OAuth failureSign-in was cancelled, the app is in development/testing mode, or the user isn't allowed to use it yet. Add the user as a tester or publish the app.
Redirect URI mismatchCopy the redirect URI from section G exactly — same https scheme, host and path, no trailing slash — into the provider's app settings.
API not enabledEnable the API/product for the project or app in the provider console and wait a few minutes.
Quota exceededWait for the quota window to reset (see section E) or request a higher quota / add credits.
Account not eligibleCheck the account requirements in section B (e.g. business/professional account, verified property, registered organisation).
App review requiredPermissions beyond development access need the provider's review before other accounts can connect. See section E for restrictions.
Billing requiredAdd a payment method or prepaid credits on the provider account (see section E).

JDisconnect & security

Revoke access at the provider
Delete the key in the provider console, then remove it from the provider card in the application.
Disconnect in the application
App → Integrations → Providers & API keys or Super Admin → Platform → Integrations → open the card → Remove / Disconnect. Connected accounts can be disconnected per brand.
Rotate credentials
Create the new key or secret first, paste it into the same card and Test, then delete the old one at the provider — no downtime.
How credentials are stored
Encrypted at rest with AES-256-GCM using the server's ENCRYPTION_KEY, shown masked after saving, never returned to the browser, and used only from the API server.
What data the application can access
Only the prompts and files you send for generation. Requests are sent from our server; the key is never exposed to the browser.

Other AI — image & video providers

Start Free