Skip to main content

Documentation Index

Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

ModelResolutionSpeedBest for
FLUX.2 ProUp to 4MPMediumProduction assets, marketing
FLUX.2 MaxUp to 4MPSlowerMaximum quality, hero images
FLUX.2 DevUp to 4MPFastPrototyping, open weights

​
Basic generation

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.