FLUX.2 Image Generation API

Generate up to 4MP images with FLUX.2 Pro, Max, and Dev. Multi-reference generation, higher detail, and improved prompt adherence over FLUX.1.

FLUX.2 is Black Forest Labs’ next-generation image model. Up to 4-megapixel output, multi-reference image support, better text rendering, and tighter prompt adherence.

Available models

Model	Resolution	Speed	Best for
FLUX.2 Pro	Up to 4MP	Medium	Production assets, marketing
FLUX.2 Max	Up to 4MP	Slower	Maximum quality, hero images
FLUX.2 Dev	Up to 4MP	Fast	Prototyping, open weights

---

Basic generation

Python

from runcrate import Runcrate

client = Runcrate(api_key="rc_live_YOUR_API_KEY")
image = client.models.generate_image(
    model="black-forest-labs/FLUX.2-pro",
    prompt="A minimalist desk setup with mechanical keyboard, ultrawide monitor, warm desk lamp, shot from above",
    aspect_ratio="16:9",
)
image.data[0].save("desk-setup.png")

---

High-resolution 4MP

from runcrate import Runcrate

client = Runcrate(api_key="rc_live_YOUR_API_KEY")
image = client.models.generate_image(
    model="black-forest-labs/FLUX.2-max",
    prompt="Macro photograph of morning dew on a spider web, bokeh background, golden hour",
    width=2048, height=2048,
)
image.data[0].save("dew-macro-4mp.png")

---

Multi-reference generation

Pass up to 8 reference images to guide style or composition:

from runcrate import Runcrate

client = Runcrate(api_key="rc_live_YOUR_API_KEY")
image = client.models.generate_image(
    model="black-forest-labs/FLUX.2-pro",
    prompt="Product hero image for premium headphones, same lighting as references",
    input_images=["./brand-ref-1.png", "./brand-ref-2.png", "./product-angle.png"],
)
image.data[0].save("headphones-hero.png")

---

Fast iteration with Dev

from runcrate import Runcrate

client = Runcrate(api_key="rc_live_YOUR_API_KEY")
for variation in ["morning light", "sunset", "overcast", "night"]:
    image = client.models.generate_image(
        model="black-forest-labs/FLUX.2-dev",
        prompt=f"Modern glass house in the mountains, {variation}, architectural photography",
        seed=42,
    )
    image.data[0].save(f"house-{variation.replace(' ', '-')}.png")

---

Tips

• Start with Dev, finish with Max. Dev is faster and cheaper for iteration.
• Aspect ratio vs dimensions. Use aspect_ratio for standard ratios, width/height for exact pixels up to 4MP.
• Multi-reference. Up to 8 images. More references = slower but more consistent style.
• Seed. Same seed + same prompt + same model = same image.