All models

flux-pro

Black Forest LabsImage
Get your API key
flux-pro

High-quality image generation model for professional visual creation

flux-pro is the image creation entry point for the Black Forest Labs FLUX Pro series, designed to turn clear text concepts into visual assets that emphasize detail, composition, and style. On this platform, it supports text-to-image generation and can also edit existing images using text instructions, making it suitable for marketing concept art, product scene drafts, and illustration exploration, with multiple aspect ratios and asynchronous task processing options.

Black Forest LabsModel brand
ImageModel type
Generate · EditCreation modes
STANDARD APIs · QUICK SETUP

Bring this model into your workflow

Submit requests to the public API at api.acedata.cloud using the documented parameters, then use the results in your application.

API host
api.acedata.cloud
model
flux-pro
Get your API key

Input parameters and result formats vary by service. Use the public API for this model and follow its guide for generation, task retrieval and editing operations.

Specifications and API features

Text creation
Enter a prompt and use generate to create images
Image editing
Use edit and provide image_url with text instructions
Pixel dimensions
1024x1024、1024x1792、1792x1024
Aspect ratio control
size supports pixel dimensions or image ratios
Number of generations
count defaults to 1 and applies only to generation tasks
Result delivery
The JSON result list provides image_url
Task processing
Supports asynchronous queries and completion callbacks

The FLUX Pro series excels at prompt adherence and visual detail; the dimensions, operations, and result formats above apply to the flux-pro entry point on this platform.

Core capabilities

Put visual requirements into the image

flux-pro focuses on prompt adherence, visual quality, and image detail. After describing the subject, you can further specify the scene, materials, lighting, camera distance, and overall style, turning a passage of text into a clear visual brief. It is well suited for adjusting composition and atmosphere around the same idea, gradually selecting images that better match the goal.

Connected generation and editing

You can create new images from text or submit an existing image link and initiate edits with text instructions. This means the workflow does not have to start from a blank canvas every time: first generate a directional draft, then request changes around the selected image. If the task emphasizes precise local modifications and overall consistency, you can further consider the Kontext series.

Adapt to different delivery formats

Square, portrait, and landscape sizes make it easy to prepare visual drafts for different layouts, and image ratios can also be used to express composition requirements. Generation tasks support a specified quantity, making it suitable for preparing multiple candidate options at once; combined with asynchronous queries or completion callbacks, image tasks can be integrated into a content production backend without keeping the user interface waiting.

Use Cases

Marketing Visual Direction Drafts

Enter the campaign theme, core subject, brand color palette, and desired atmosphere to generate candidate images for advertising backgrounds or promotional visuals. Landscape formats are suitable for exploring key visual layouts, while portrait formats work well for content covers. Deliverables can serve as design communication drafts, after which designers can add official copy, logos, and typography, rather than directly replacing complete ad production.

Product Scene Exploration

Generate scene drafts around product appearance descriptions, placement methods, background materials, and lighting to compare studio-style, lifestyle, or artistic expressions. Existing images can also be used as editing inputs. When actual products are involved, compare the results item by item with the real appearance before deciding which images are suitable for subsequent production.

Illustration and Concept Design

Turn character settings, environmental relationships, color schemes, and artistic direction into prompts to generate illustration or scene concept candidates. Explore different expressions of the same subject by changing the perspective, lighting, and style descriptions. The final deliverable can be a set of direction images for illustrators or art teams to select and refine further, rather than requiring all details to be completed at once.

How to Choose This Model

Choose Pro When Image Quality Matters

If the goal is to prepare visual assets for a formal project and you care about prompt expression, details, and image quality, flux-pro is worth considering. flux-dev is better suited for development testing and early-stage concept exploration. FLUX.1 [pro] and FLUX1.1 [pro] are different native versions; when calling flux-pro, its name should not be arbitrarily rewritten as 1.1, nor should specific acceleration effects be assumed based on this.

Choose Based on Generation and Editing Priorities

If starting from a text concept and needing multiple composition candidates, use flux-pro; if the core task is context-aware modification of existing images, it is more suitable to compare flux-kontext-pro or flux-kontext-max. When considering the Flux 2 series, also note the difference in size notation: these endpoints use image aspect ratios and cannot directly copy flux-pro's pixel size settings.

Get Started

Clearly Define Visual Goals and Elements to Preserve

For text-to-image, specify the subject, materials, lighting, and canvas format; for modifying existing images, prepare image_url and clearly describe what to change and preserve.

Call Image Operations for This Model

Submit model=flux-pro, action=generate, prompt, and size=1024x1024 to /flux/images; when editing images, choose edit and provide the image URL, while count is only used for generation.

Evaluate Based on Image Results

Save the returned image_url; for asynchronous requests, query via task_id or configure callback_url. Compare key elements before and after modification, then use the generated images in subsequent design work.

Trial suggestion: product image with materials and lighting

Input and goal

A frosted glass perfume bottle placed on a dark stone pedestal, with soft light from the left illuminating the bottle, a simple background, emphasizing glass, stone, and shadows, with no logo text added.

Review and next steps

Zoom in to inspect the materials, bottle perspective, and reflections; when you need to continuously preserve details around the original image, compare the specialized Kontext editing model.

Usage boundaries

  • Text-to-image does not mean every layout constraint can be executed precisely. For brand visuals, product appearance, or complex compositions, clearly specify key requirements and inspect the results after generation; when logos, body text, and layout need fixed positions, it is appropriate to use the image as a visual draft and then proceed to the design production stage.
  • The editing endpoint for flux-pro requires an image link and a text instruction, but ordinary editing should not be understood as automatically having Kontext's contextual editing capabilities. If the scope of modifications, subject preservation, or continuous editing is central to the task, prioritize comparing specialized editing models and assess suitability through sample images.
  • Generation quantity control is not used for editing tasks; the seed in the results is also not equivalent to a seed control parameter that can be submitted. Please use size to specify dimensions; both generation and editing should provide action, prompt, and size, and avoid directly using parameter syntax from other Flux models for flux-pro.

Frequently Asked Questions

Is flux-pro the same as FLUX1.1 [pro]?

When calling it, use the exact model ID flux-pro; do not rewrite it as FLUX1.1 [pro]. FLUX.1 [pro] and FLUX1.1 [pro] are different versions; when choosing this option, evaluate it based on image quality, prompt adherence, and actual task results rather than assuming 1.1 speed performance.

Can flux-pro edit existing images?

Yes. Use action=edit, and provide image_url, the modification instruction prompt, and size. Edit tasks do not use count to control the quantity. If you want more targeted, context-aware modifications based on an existing image, it is recommended to also compare flux-kontext-pro or flux-kontext-max.

How should size be specified for flux-pro?

You can use 1024x1024, 1024x1792, or 1792x1024, or specify an image aspect ratio. First choose a square, landscape, or portrait format based on the final layout, then describe the subject position and whitespace requirements in the prompt. When using Flux 2 or Kontext, use their corresponding aspect-ratio formats instead.

How can I generate multiple candidate images at once?

In a generate task, specify the number of images with count; one image is generated by default. The returned data list provides links for each image. This is suitable for keeping the main description unchanged, comparing multiple candidates first, and then adjusting the prompt to continue exploring. count does not apply to edit and does not mean every result will be exactly the same.

How can I integrate this into a backend image-production workflow?

Submit the model, operation, prompt, and size to POST /flux/images. You can set async=true, then query the task result after obtaining task_id; you can also use callback_url to receive completion notifications. After completion, read image_url from data, then pass it to asset management, review, or design workflows for processing.