FLUX 3 Image now available on AI Gateway

FLUX 3 Image from Black Forest Labs is now available on AI Gateway. Generate images from text or edit existing images using the same model, with one API key and no Black Forest Labs account required.

FLUX 3 Image supports up to ten reference images for editing, combining subjects, or changing the composition. It supports five resolution tiers from 768 × 768 to 4K, with square, portrait, and landscape aspect ratios.

Set AI_GATEWAY_API_KEY, then use bfl/flux-3-image as the model ID in AI SDK 7 or later. To generate an image, call generateImage with a text prompt:

1
import { generateImage } from 'ai';
2

3
const { image } = await generateImage({
4
  model: 'bfl/flux-3-image',
5
  prompt: 'A blue ceramic vase with wildflowers on a sunlit wooden table.',
6
  aspectRatio: '1:1',
7
  providerOptions: {
8
    blackForestLabs: { resolution: '1k' },
9
  },
10
});

To edit an image, pass it in prompt.images with an instruction. This example edits the image generated above:

1
const { image: editedImage } = await generateImage({
2
  model: 'bfl/flux-3-image',
3
  prompt: {
4
    text: 'Change the vase to terracotta and keep the flowers and setting.',
5
    images: [image.uint8Array],
6
  },
7
  aspectRatio: '1:1',
8
  providerOptions: {
9
    blackForestLabs: { resolution: '1k' },
10
  },
11
});

You can also use FLUX 3 Image from the terminal using the same AI Gateway API key and model ID with AI CLI.

Try FLUX 3 Image in the model playground, or see the image generation guide.