# FLUX.1 Kontext Pro – Text-Guided Image Editing Model
## What is FLUX.1 Kontext Pro?
FLUX.1 Kontext Pro is an advanced AI-driven, text-guided image editing model that transforms simple prompts into professional-grade visuals with speed and precision. Engineered for seamless API integration, it automates complex, multi-step manipulations—such as object alteration, style transfer, and background replacement—while maintaining consistent image quality. Whether you’re a developer building dynamic image pipelines, a creator seeking intuitive editing commands, or a product manager streamlining marketing mockups, FLUX.1 Kontext Pro delivers reliable, high-fidelity results.
## Key Features
- Text-Guided Editing: Convert natural-language prompts into precise image transformations.
- Multi-Image Fusion: Merge two input images (JPEG/PNG/GIF/WEBP) into a seamless composition.
- Style Transfer & Background Replacement: Apply artistic styles or swap backgrounds without artifacts.
- API-First Design: Easy integration via REST endpoints; ideal for automated workflows.
- Fast Performance: Millisecond-scale inference for rapid iteration on prototypes and campaigns.
- Parameter Control:
- prompt (required): Describe desired edits (“Merge the images to create a new, imaginative scene”).
- input_image_1, input_image_2 (required): Supply high-resolution URLs for best output.
- aspect_ratio (optional): Choose from common ratios (1:1, 16:9, 4:3, etc.) or match_input_image.
- seed (advanced): Set an integer for reproducible results or omit for random variations.
- output_format (advanced): Select “png” for maximum fidelity or “jpg” for smaller file size.
- safety_tolerance (advanced): Adjust filtering strictness (0 = strict, 2 = lenient).
## Best Use Cases
- Automated Marketing Visuals: Generate on-brand banners, ads, and social posts at scale.
- Product Mockups: Swap backgrounds and tweak product angles for e-commerce catalogs.
- Creative Prototyping: Explore style blends, object augmentations, and surreal composites.
- App Integrations: Embed real-time image editing in web or mobile applications.
- Content Personalization: Dynamically tailor visuals based on user preferences or A/B tests.
## Prompt Tips and Output Quality
- Be Descriptive: Specify objects, styles, or moods (“Replace beach background with a rainy cityscape”).
- Use High-Quality Inputs: Provide clear, high-resolution images for crisp composites.
- Control Aspect Ratio: Match your target display (e.g., 16:9 for widescreen, 1:1 for social).
- Lock the Seed: Reuse `seed=1234` to reproduce exact outputs for testing.
- Balance Safety Tolerance: Start at `safety_tolerance=1` to filter unwanted content without over-strictness.
- Preview & Iterate: Adjust prompts and advanced parameters to fine-tune color, composition, and detail.
Multi Image Kontext Pro
Transform text into stunning, professional-grade images with precise editing capabilities.
Example output

# Guide to Using FLUX.1 Kontext Pro Effectively
FLUX.1 Kontext Pro is a powerful text-guided image editing model that automates complex visual transformations via REST API. This guide covers essential parameters, best practices, and tailored recommendations for common workflows.
## Getting Started
1. **API Call Structure**
• POST `/edit` with JSON body:
```json
{
"prompt": "Merge the images to create a dreamy sunset scene",
"input_image_1": "https://example.com/img1.png",
"input_image_2": "https://example.com/img2.png",
"aspect_ratio": "16:9",
"seed": 42,
"output_format": "png",
"safety_tolerance": 1
}
```
2. **Required Fields**
- `prompt` (str): Natural-language description.
- `input_image_1`, `input_image_2` (URLs): High-resolution JPEG, PNG, GIF, or WEBP.
## Key Parameters
- **aspect_ratio** (advanced):
• `match_input_image` for minimal cropping
• Common presets: `1:1`, `16:9`, `4:3`
- **seed** (advanced):
• Fixed integer (e.g., `1234`) for reproducibility
• Omit for randomized variations
- **output_format** (advanced):
• `png` for maximum fidelity
• `jpg` for smaller file size
- **safety_tolerance** (advanced):
• `0` = strict filtering
• `1` = balanced
• `2` = lenient, creative freedom
## Use Case Recommendations
1. **Automated Marketing Visuals**
- aspect_ratio: `16:9` (banners) or `1:1` (social)
- output_format: `jpg` for faster load times
- seed: omit for diverse A/B testing
- safety_tolerance: `1` to block unwanted content
2. **E-Commerce Product Mockups**
- aspect_ratio: `4:3` or `match_input_image`
- output_format: `png` for transparency and crisp detail
- seed: fixed (e.g., `1234`) for consistent catalog styling
- safety_tolerance: `0` to enforce brand-safe imagery
3. **Creative Prototyping**
- aspect_ratio: `match_input_image` or unconventional `9:16` vertical
- output_format: `png`
- seed: random (omit) to explore variations
- safety_tolerance: `2` for unrestricted creativity
4. **App & Web Integration**
- aspect_ratio: adapt to UI slots (`1:1` for avatars, `21:9` for headers)
- output_format: `jpg` if bandwidth-sensitive
- seed: dynamic (variable per session)
- safety_tolerance: `1` to balance safety and flexibility
## Best Practices
- Be **descriptive** in your prompt: mention styles, colors, objects, and moods.
- Use **high-resolution inputs** (≥1024×1024 px) to maintain crisp composites.
- **Iterate**: preview results, tweak parameters, and refine prompts.
- Lock the seed when you need **exact reproducibility** across runs.
- Start with `safety_tolerance=1` and adjust based on your content guidelines.
By following this guide, you’ll unlock FLUX.1 Kontext Pro’s full potential—delivering fast, reliable, and high-quality image edits for any application.
How do I edit images with FLUX.1 Kontext Pro?
A: Call the API with two image URLs and a prompt string. Optionally set aspect_ratio, seed, and output_format.
What file formats are supported?
A: Input: JPEG, PNG, GIF, WEBP. Output: “png” (default) or “jpg”.
Can I control the output aspect ratio?
A: Yes. Use aspect_ratio values like “1:1”, “16:9”, or “match_input_image” to fit your layout.
How do I ensure reproducible results?
A: Include a fixed integer in the seed parameter (e.g., seed=1234) for consistent outputs.
What does safety_tolerance mean?
A: It adjusts the model’s content filter: 0 = strict, 2 = more lenient. Default is 2 for creative flexibility.
Related Models
Discover other powerful AI models

