Skip to main content

Image Generation

Image Generation lets your users create images from a text prompt directly inside the Media Library. Generated images are added to the workspace's media, ready to attach to posts.

Requirements​

Before enabling Image Generation, make sure the following are in place:

  • An image-capable AI service. Only OpenAI and Gemini support image generation. At least one of them must be connected and active under Admin Console -> Services.

Enable and Configure​

Image Generation is configured once, at the instance level, by an administrator.

  1. Navigate to Admin Console -> Settings -> AI.
  2. Scroll to the Image section.
  3. Choose an Image provider and, optionally, an Image model (see below).
  4. Save the changes.

Once saved, an AI button appears in the Media Library's upload area.

Image Provider​

The Image provider dropdown lists only providers that support image generation (OpenAI and Gemini).

  • Select a provider to always use that specific service for image generation, regardless of your default AI provider.
  • Leave it empty to fall back to your default AI provider — but only if that provider supports image generation. If your default provider is text-only (for example Anthropic), image generation stays disabled until you pick an image-capable provider here.
note

The chosen AI provider must also be connected and Active under Admin Console -> Services. The provider selector only controls which service is used — it does not supply the API credentials.

Image Model​

The Image model dropdown lists the image models available for the selected provider, plus a Custom model ID option.

  • Leave it empty to use the provider's recommended default image model.
  • Pick a model from the list to pin a specific one.
  • Choose Custom model ID to type any image model identifier the provider supports — useful for newly released models that aren't in the list yet.

Supported Providers and Models​

ProviderImage modelsDefault model
OpenAIgpt-image-2, gpt-image-1.5, gpt-image-1, gpt-image-1-minigpt-image-2
Geminigemini-3.1-flash-lite-image, gemini-3.1-flash-image, gemini-3-pro-image, gemini-2.5-flash-imagegemini-3-pro-image

Generating an Image​

Once Image Generation is enabled, any workspace user can create images:

  1. Open the Media Library (or the media picker when creating a post).
  2. In the upload area, click AI.
  3. Enter a prompt describing the image you want.
  4. Click Generate.

Generation runs in the background and can take up to a couple of minutes. When it finishes, the image is added to the workspace's media library and selected automatically.

note

Because generation runs as a background job, the image is saved to the media library even if you close the panel while it's still working — it simply won't be auto-selected in that session. You'll find it in the library afterwards.

Troubleshooting​

The AI button doesn't appear in the Media Library. Image Generation is disabled. Confirm that an image-capable provider is selected in Admin Console -> Settings -> AI -> Image (or that your default AI provider supports images), and that the provider is Active under Services.

Generation spins forever and never completes. The most common causes are a queue worker that isn't processing the mixpost-media queue, or an array cache driver. Verify your worker is running and that CACHE_STORE points to a shared store.

Generation fails immediately. Check that the provider's API key is valid and the account has image-generation access and available credits. Administrators see the underlying provider error message; other users see a generic message.

On this page