black-forest-labs/flux-2-pro

High-quality image generation and editing with support for eight reference images

Capabilities

1:14:33:416:99:162:33:2Reference ImagesSeed

Cost

Community model (estimated from hardware time)

Input Parameters

Name	Type	Description	Default	Constraints
`prompt`*	string	Text prompt for image generation	`—`	—
`aspect_ratio`	string	Aspect ratio for the generated image. Use 'match_input_image' to match the first input image's aspect ratio.	`"1:1"`	match_input_imagecustom1:116:93:22:34:55:49:163:44:3
`height`	integer	Height of the generated image. Only used when aspect_ratio=custom. Must be a multiple of 16 (if it's not, it will be rounded to nearest multiple of 16).	`—`	min: 256, max: 2048
`input_images`	array	List of input images for image-to-image generation. Maximum 8 images. 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 in megapixels. Up to 4 MP is possible, but 2 MP or below is recommended. The maximum image size is 2048x2048, which means that high-resolution images may not respect the resolution if aspect ratio is not 1:1. Resolution is not used when aspect_ratio is 'custom'. When aspect_ratio is 'match_input_image', use 'match_input_image' to match the input image's resolution (clamped to 0.5-4 MP).	`"1 MP"`	match_input_image0.5 MP1 MP2 MP4 MP
`safety_tolerance`	integer	Safety tolerance, 1 is most strict and 5 is most permissive	`2`	min: 1, max: 5
`seed`	integer	Random seed. Set for reproducible generation	`—`	—
`width`	integer	Width of the generated image. Only used when aspect_ratio=custom. Must be a multiple of 16 (if it's not, it will be rounded to nearest multiple of 16).	`—`	min: 256, max: 2048

promptrequiredstring

Text prompt for image generation

aspect_ratiostring

Aspect ratio for the generated image. Use 'match_input_image' to match the first input image's aspect ratio.

Default: "1:1"

match_input_imagecustom1:116:93:22:34:55:49:163:44:3

heightinteger

Height of the generated image. Only used when aspect_ratio=custom. Must be a multiple of 16 (if it's not, it will be rounded to nearest multiple of 16).

min: 256, max: 2048

input_imagesarray

List of input images for image-to-image generation. Maximum 8 images. 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 in megapixels. Up to 4 MP is possible, but 2 MP or below is recommended. The maximum image size is 2048x2048, which means that high-resolution images may not respect the resolution if aspect ratio is not 1:1. Resolution is not used when aspect_ratio is 'custom'. When aspect_ratio is 'match_input_image', use 'match_input_image' to match the input image's resolution (clamped to 0.5-4 MP).

Default: "1 MP"

match_input_image0.5 MP1 MP2 MP4 MP

safety_toleranceinteger

Safety tolerance, 1 is most strict and 5 is most permissive

Default: 2min: 1, max: 5

seedinteger

Random seed. Set for reproducible generation

widthinteger

Width of the generated image. Only used when aspect_ratio=custom. Must be a multiple of 16 (if it's not, it will be rounded to nearest multiple of 16).

min: 256, max: 2048

Version: ccb5e3314109Updated: 7/25/20267.6M runs