black-forest-labs/flux-3-image

OfficialView on Replicate →

FLUX 3 is Black Forest Labs' text-to-image and image-editing model. Generate images from a prompt, or edit with up to 10 reference images.

Capabilities

No capability data available

Cost

Community model (estimated from hardware time)

Input Parameters

Name	Type	Description	Default	Constraints
`prompt`*	string	Text description of the image to generate, or of the edit to apply to the reference images.	`—`	—
`aspect_ratio`	string	Aspect ratio of the generated image. 'auto' picks the ratio from the prompt and the first reference image.	`"auto"`	auto21:92:116:93:27:54:35:41:14:53:45:72:39:161:29:21
`grounding`	boolean	Let the model research the prompt with web search and image search before generating.	`true`	—
`images`	array	Up to 10 reference images the prompt edits or draws from. When present, the request runs as an edit and the first image drives 'auto' aspect ratio. Each image must be at least 256x256 px and at most 16 MP. Must be jpeg, png, gif, or webp.		—
`output_format`	string	Format of the output images.	`"webp"`	webpjpgpng
`output_quality`	integer	Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs	`80`	min: 0, max: 100
`resolution`	string	Resolution of the output image. Input images are resized to the closest bin, up to 2k.	`"1k"`	768sq1k1.5k2k4k
`safety_tolerance`	integer	Moderation tolerance for inputs and outputs. 0 is the strictest, 4 is the most permissive.	`2`	min: 0, max: 4

promptrequiredstring

Text description of the image to generate, or of the edit to apply to the reference images.

aspect_ratiostring

Aspect ratio of the generated image. 'auto' picks the ratio from the prompt and the first reference image.

Default: "auto"

auto21:92:116:93:27:54:35:41:14:53:45:72:39:161:29:21

groundingboolean

Let the model research the prompt with web search and image search before generating.

Default: true

imagesarray

Up to 10 reference images the prompt edits or draws from. When present, the request runs as an edit and the first image drives 'auto' aspect ratio. Each image must be at least 256x256 px and at most 16 MP. Must be jpeg, png, gif, or webp.

Default:

output_formatstring

Format of the output images.

Default: "webp"

webpjpgpng

output_qualityinteger

Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs

Default: 80min: 0, max: 100

resolutionstring

Resolution of the output image. Input images are resized to the closest bin, up to 2k.

Default: "1k"

768sq1k1.5k2k4k

safety_toleranceinteger

Moderation tolerance for inputs and outputs. 0 is the strictest, 4 is the most permissive.

Default: 2min: 0, max: 4

Version: ec84b8fbf178Updated: 10/10/2026740 runs