FLUX.2 Image Generation API - Runcrate

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

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")

import Runcrate from '@runcrate/sdk';

const rc = new Runcrate({ apiKey: 'rc_live_YOUR_API_KEY' });
const image = await rc.models.generateImage({
  model: 'black-forest-labs/FLUX.2-pro',
  prompt: 'A minimalist desk setup with mechanical keyboard, ultrawide monitor, warm desk lamp',
  aspectRatio: '16:9',
});
await image.save('desk-setup.png');

import { runcrate } from '@runcrate/ai';
import { generateImage } from 'ai';

const { image } = await generateImage({
  model: runcrate.imageModel('black-forest-labs/FLUX.2-pro'),
  prompt: 'Minimalist desk setup with mechanical keyboard, ultrawide monitor',
  size: '1792x1024',
});

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.