Introduction: The Flux Image Matrix
Black Forest Labs’ Flux stack spans a mature Kontext line (unified generate/edit with governance knobs) and a newer Flux 2 family split into standard and Pro tiers for 1K/2K output. On FuseAI Tools, five tabs under /home/flux-kontext map to those workflows.
The common question: when do you need Kontext’s translation, safety, and watermark controls—and when should you move to Flux 2 or Flux 2 Pro for aspect-ratio breadth and multi-image editing?
Flux hub: /home/flux-kontext
I. Snapshot: Five Scenarios at a Glance
| Scenario | Core function | Resolution | Aspect ratios | Reference images | Positioning |
|---|---|---|---|---|---|
| Kontext generate | Text-to-image + edit | Standard | 6 ratios | Optional (edit) | Pro / Max, governance |
| Flux 2 T2I | Text-to-image | 1K / 2K | 8 + auto | ❌ | Fast 2K drafts |
| Flux 2 I2I | Image-to-image | 1K / 2K | 8 + auto | ✅ (1–8) | Multi-ref edit |
| Flux 2 Pro T2I | Text-to-image | 1K / 2K | 8 + auto | ❌ | Higher-fidelity T2I |
| Flux 2 Pro I2I | Image-to-image | 1K / 2K | 8 + auto | ✅ (1–8) | Pro multi-ref edit |
Note: API docs may label the standard Flux 2 tier as “Flex”; on FuseAI Tools the routes are flux-2-text-to-image and flux-2-image-to-image.
II. Five Scenarios Deep Dive
Scenario 1: Kontext generate (flux-kontext-pro / flux-kontext-max)
One tab covers both pure generation and single-image editing. Pick Pro for balanced speed/quality or Max for heavier detail on complex briefs.
{
"model": "flux-kontext-pro",
"prompt": "English prompt describing the image or edit",
"enableTranslation": true,
"imageUrl": "Optional source image URL (edit mode)",
"aspectRatio": "RATIO_16_9",
"outputFormat": "JPEG",
"promptUpsampling": false,
"safetyTolerance": 2,
"watermark": "your-watermark-id"
}
Key controls:
- enableTranslation — auto-translate non-English prompts (UI recommends English).
- promptUpsampling — MagicPrompt-style enhancement (slower).
- safetyTolerance — 0 (strictest) through 6 (more relaxed).
- watermark — optional ID embedded on output (max 100 chars on FuseAI Tools).
Aspect ratios: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 (unique ultra-wide 21:9 vs Flux 2 line).
Best for: everyday generation, governed edits, teams that need translation and safety sliders.
Route: /home/flux-kontext/generate
Scenario 2: Flux 2 text-to-image
Entry-tier Flux 2 text-to-image with explicit 1K/2K resolution and eight aspect presets plus auto.
{
"model": "flux-2-text-to-image",
"prompt": "3-5000 characters",
"aspectRatio": "16:9",
"resolution": "2K"
}
Aspect ratios: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto.
Best for: quick 2K stills, social crops, cost-conscious iteration.
Route: /home/flux-kontext/flux-2-text-to-image
Scenario 3: Flux 2 image-to-image
Same resolution and ratio stack as Flux 2 T2I, plus 1–8 reference uploads for fusion edits (e.g., swap a product from image B into scene A).
{
"model": "flux-2-image-to-image",
"inputUrls": ["https://example.com/ref-1.jpg", "https://example.com/ref-2.jpg"],
"prompt": "Describe the edit (3-5000 characters)",
"aspectRatio": "3:4",
"resolution": "2K"
}
Best for: multi-reference compositing, localized swaps, catalog variations.
Route: /home/flux-kontext/flux-2-image-to-image
Scenario 4: Flux 2 Pro text-to-image
Parameter surface matches Flux 2 T2I; Pro targets higher perceptual quality and detail for delivery assets.
{
"model": "flux-2-pro-text-to-image",
"prompt": "3-5000 characters",
"aspectRatio": "16:9",
"resolution": "2K"
}
vs Flux 2 T2I: same fields; choose Pro when quality outweighs speed/credits on your plan.
Best for: hero banners, campaign key visuals, print-minded 2K stills.
Route: /home/flux-kontext/flux-2-pro-text-to-image
Scenario 5: Flux 2 Pro image-to-image
Pro-grade image-to-image with up to eight references—mirror of Flux 2 I2I with a higher-fidelity backend tier.
{
"model": "flux-2-pro-image-to-image",
"inputUrls": ["https://example.com/person.jpg", "https://example.com/shirt.jpg"],
"prompt": "Have the person in image 1 wear the shirt from image 2",
"aspectRatio": "3:4",
"resolution": "2K"
}
Best for: precise multi-image fusion, fashion/product pipelines, final retouch passes.
Route: /home/flux-kontext/flux-2-pro-image-to-image
III. Cross-Scenario Comparison
3.1 Capability matrix
| Feature | Kontext | 2 T2I | 2 I2I | Pro T2I | Pro I2I |
|---|---|---|---|---|---|
| Text-to-image | ✅ | ✅ | ❌ | ✅ | ❌ |
| Image-to-image | ✅ (1 img) | ❌ | ✅ | ❌ | ✅ |
| 1K / 2K resolution | ❌ | ✅ | ✅ | ✅ | ✅ |
| Multi-ref (≤8) | ❌ | ❌ | ✅ | ❌ | ✅ |
| auto aspect ratio | ❌ | ✅ | ✅ | ✅ | ✅ |
| Auto translation | ✅ | ❌ | ❌ | ❌ | ❌ |
| Prompt upsampling | ✅ | ❌ | ❌ | ❌ | ❌ |
| Safety tolerance | ✅ | ❌ | ❌ | ❌ | ❌ |
| Watermark ID | ✅ | ❌ | ❌ | ❌ | ❌ |
3.2 Prompt limits
| Line | Prompt limit | Language |
|---|---|---|
| Kontext | ≤ 5000 chars (UI) | English recommended; optional auto-translate |
| Flux 2 / Pro | 3–5000 chars | Any (write clear English for best results) |
3.3 Aspect ratio coverage
| Ratio | Kontext | Flux 2 / Pro |
|---|---|---|
| 21:9 | ✅ | ❌ |
| 16:9 / 9:16 | ✅ | ✅ |
| 4:3 / 3:4 / 1:1 | ✅ | ✅ |
| 3:2 / 2:3 | ❌ | ✅ |
| auto | ❌ | ✅ |
IV. Selection Decision Tree
What do you need first?
|
|-- Governance: translation, safety slider, watermark, 21:9
| `-- Kontext generate (Pro or Max)
|
|-- 2K output + rich ratios (incl. 3:2, 2:3, auto)
| |-- Text only -> Flux 2 T2I or Flux 2 Pro T2I
| `-- 1-8 reference images -> Flux 2 I2I or Flux 2 Pro I2I
|
`-- Multi-image fusion edit
`-- Flux 2 I2I (draft) or Flux 2 Pro I2I (delivery)
V. Practical Payload Examples
Kontext edit with translation
{
"model": "flux-kontext-pro",
"prompt": "Change the background to a sunset beach",
"enableTranslation": true,
"imageUrl": "https://example.com/portrait.jpg",
"aspectRatio": "RATIO_16_9"
}
Flux 2 — 2K landscape
{
"model": "flux-2-text-to-image",
"prompt": "Serene mountain lake at sunset, orange sky reflected in still water",
"aspectRatio": "16:9",
"resolution": "2K"
}
Flux 2 Pro — multi-image fusion
{
"model": "flux-2-pro-image-to-image",
"inputUrls": [
"https://example.com/person.jpg",
"https://example.com/shirt.jpg"
],
"prompt": "Person from image 1 wearing the shirt from image 2",
"aspectRatio": "3:4",
"resolution": "2K"
}
VI. Final Recommendations
| Use case | Scenario | Why |
|---|---|---|
| All-in-one with controls | Kontext generate | Translation, safety, watermark, 21:9 |
| Fast 2K text-to-image | Flux 2 T2I | Best credits/speed tradeoff |
| Multi-ref editing | Flux 2 I2I | Up to 8 inputUrls |
| Delivery-quality T2I | Flux 2 Pro T2I | Highest Flux 2 text tier |
| Delivery-quality I2I | Flux 2 Pro I2I | Pro fusion + 2K |
One-line playbook:
- Controls + single-image edit → Kontext generate.
- Everyday 2K → Flux 2 T2I / Flux 2 I2I.
- Final quality → Flux 2 Pro T2I / Flux 2 Pro I2I.
Kontext and Flux 2 complement each other: draft and govern on Kontext, scale to 2K and multi-reference on Flux 2. Open all modes from /home/flux-kontext.
