fal-text-to-image

What this skill does

## Quick Reference

| Model | Endpoint | Speed | Quality | Cost |
|-------|----------|-------|---------|------|
| FLUX.2 Pro | `fal-ai/flux-2-pro` | Medium | Highest | $$$ |
| FLUX.1 Dev | `fal-ai/flux/dev` | Medium | High | $$ |
| FLUX Schnell | `fal-ai/flux/schnell` | Fast | Good | $ |
| Fast SDXL | `fal-ai/fast-sdxl` | Fast | Good | $ |

| Image Size | Preset | Dimensions |
|------------|--------|------------|
| Square HD | `square_hd` | 1024x1024 |
| Landscape | `landscape_16_9` | 1024x576 |
| Portrait | `portrait_16_9` | 576x1024 |
| Custom | `{ width, height }` | Any |

| Parameter | FLUX Default | SDXL Default |
|-----------|--------------|--------------|
| `guidance_scale` | 3.5 | 7.5 |
| `num_inference_steps` | 28 | 25 |
| `num_images` | 1 | 1 |

## When to Use This Skill

Use for **text-to-image generation**:
- Generating images from text prompts
- Choosing between FLUX and SDXL models
- Configuring image sizes and quality parameters
- Using LoRA models for custom styles
- Batch generating multiple images

**Related skills:**
- For image editing: see `fal-image-to-image`
- For model comparison: see `fal-model-guide`
- For API integration: see `fal-api-reference`

---

# fal.ai Text-to-Image Models

Complete reference for all text-to-image generation models on fal.ai.

## FLUX Models

### FLUX.1 [dev]
**Endpoint:** `fal-ai/flux/dev`
**Pricing:** $0.025/megapixel
**Best For:** High-quality open-source generation

The 12B parameter FLUX.1 model offers excellent quality with open-source accessibility.

```typescript
import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/flux/dev", {
  input: {
    prompt: "A serene Japanese garden with cherry blossoms, koi pond, wooden bridge, soft morning light",
    image_size: "landscape_16_9",
    num_inference_steps: 28,
    guidance_scale: 3.5,
    num_images: 1,
    seed: 42,
    enable_safety_checker: true,
    output_format: "jpeg"
  }
});

console.log(result.images[0].url);
```

```python
import fal_client

result = fal_client.subscribe(
    "fal-ai/flux/dev",
    arguments={
        "prompt": "A serene Japanese garden with cherry blossoms",
        "image_size": "landscape_16_9",
        "num_inference_steps": 28,
        "guidance_scale": 3.5,
        "num_images": 1,
        "seed": 42,
        "enable_safety_checker": True,
        "output_format": "jpeg"
    }
)
print(result["images"][0]["url"])
```

### FLUX Schnell
**Endpoint:** `fal-ai/flux/schnell`
**Pricing:** Lower cost per image
**Best For:** Fast iteration, previews, 4-step generation

Optimized for speed with only 4 inference steps required.

```typescript
const result = await fal.subscribe("fal-ai/flux/schnell", {
  input: {
    prompt: "A colorful abstract painting",
    image_size: "square_hd",
    num_inference_steps: 4,  // Optimized for 4 steps
    num_images: 1
  }
});
```

### FLUX Pro
**Endpoint:** `fal-ai/flux-pro`
**Pricing:** Premium
**Best For:** Production workloads

```typescript
const result = await fal.subscribe("fal-ai/flux-pro", {
  input: {
    prompt: "Professional product photography of a luxury watch",
    image_size: "square_hd",
    num_inference_steps: 28,
    guidance_scale: 3.5
  }
});
```

### FLUX.2 [pro]
**Endpoint:** `fal-ai/flux-2-pro`
**Pricing:** $0.03/megapixel
**Best For:** Highest quality, automatic prompt enhancement

The latest FLUX model with built-in prompt optimization.

```typescript
const result = await fal.subscribe("fal-ai/flux-2-pro", {
  input: {
    prompt: "A majestic lion in the savanna at golden hour",
    image_size: "landscape_16_9",
    num_inference_steps: 28,
    guidance_scale: 3.5,
    // FLUX 2 Pro features
    safety_tolerance: "2",  // 1-6, higher = more permissive
    raw: false  // Set true to disable prompt enhancement
  }
});
```

**FLUX.2 Pro Specific Parameters:**
- `safety_tolerance`: 1-6, controls content filtering sensitivity
- `raw`: Boolean, set to `true` to disable automatic prompt enhancement

### FLUX LoRA
**Endpoint:** `fal-ai/flux-lora`
**Best For:** Custom trained styles and subjects

Apply custom LoRA models to FLUX generation.

```typescript
const result = await fal.subscribe("fal-ai/flux-lora", {
  input: {
    prompt: "A portrait in the style of <lora_trigger>",
    loras: [
      {
        path: "https://huggingface.co/user/lora-model/resolve/main/lora.safetensors",
        scale: 0.8
      }
    ],
    image_size: "portrait_4_3",
    num_inference_steps: 28,
    guidance_scale: 3.5
  }
});
```

**LoRA Parameters:**
- `loras`: Array of LoRA configurations
  - `path`: URL to LoRA weights (.safetensors)
  - `scale`: 0-1, strength of LoRA effect

### FLUX Realism
**Endpoint:** `fal-ai/flux-realism`
**Best For:** Photorealistic images

```typescript
const result = await fal.subscribe("fal-ai/flux-realism", {
  input: {
    prompt: "A photorealistic portrait of a young woman, natural lighting, 85mm lens",
    image_size: "portrait_4_3",
    num_inference_steps: 28
  }
});
```

### FLUX Fill (Outpainting)
**Endpoint:** `fal-ai/flux-pro/v1/fill`
**Best For:** Extending images beyond boundaries

```typescript
const result = await fal.subscribe("fal-ai/flux-pro/v1/fill", {
  input: {
    prompt: "Continue the landscape with mountains",
    image_url: "https://example.com/partial-image.jpg",
    mask_url: "https://example.com/outpaint-mask.png"
  }
});
```

## Stable Diffusion Models

### Fast SDXL
**Endpoint:** `fal-ai/fast-sdxl`
**Best For:** Speed and cost efficiency

```typescript
const result = await fal.subscribe("fal-ai/fast-sdxl", {
  input: {
    prompt: "A fantasy castle on a cliff, dramatic lighting",
    negative_prompt: "blurry, low quality, distorted",
    image_size: "landscape_16_9",
    num_inference_steps: 25,
    guidance_scale: 7.5,
    num_images: 1,
    seed: 42
  }
});
```

**SDXL-Specific Parameters:**
- `negative_prompt`: What to avoid in generation
- Higher `guidance_scale` (7-12) works better for SDXL

### Stable Diffusion 3 Medium
**Endpoint:** `fal-ai/stable-diffusion-v3-medium`
**Best For:** SD3 architecture, good text rendering

```typescript
const result = await fal.subscribe("fal-ai/stable-diffusion-v3-medium", {
  input: {
    prompt: "A sign that says 'Hello World' in neon lights",
    negative_prompt: "blurry, distorted text",
    image_size: "square_hd",
    num_inference_steps: 28,
    guidance_scale: 7.0
  }
});
```

### SDXL Turbo
**Endpoint:** `fal-ai/sdxl-turbo`
**Best For:** Ultra-fast, single-step generation

```typescript
const result = await fal.subscribe("fal-ai/sdxl-turbo", {
  input: {
    prompt: "A cute robot",
    num_inference_steps: 1,  // Single step!
    guidance_scale: 0  // No guidance needed
  }
});
```

### SDXL Lightning
**Endpoint:** `fal-ai/fast-lightning-sdxl`
**Best For:** Fast 4-step SDXL

```typescript
const result = await fal.subscribe("fal-ai/fast-lightning-sdxl", {
  input: {
    prompt: "A beautiful sunset",
    num_inference_steps: 4,
    guidance_scale: 1.5
  }
});
```

## Specialized Models

### Recraft V3
**Endpoint:** `fal-ai/recraft-v3`
**Best For:** Design assets, illustrations, vector-style

```typescript
const result = await fal.subscribe("fal-ai/recraft-v3", {
  input: {
    prompt: "A minimalist logo for a tech startup, clean lines",
    image_size: "square_hd",
    style: "digital_illustration"  // or "realistic_image", "vector_illustration"
  }
});
```

**Recraft Styles:**
- `realistic_image`
- `digital_illustration`
- `vector_illustration`
- `icon`

### Ideogram
**Endpoint:** `fal-ai/ideogram`
**Best For:** Text in images, typography

```typescript
const result = await fal.subscribe("fal-ai/ideogram", {
  input: {
    prompt: "A vintage poster with the text 'JAZZ FESTIVAL' in art deco style",
    aspect_ratio: "portrait_4_3"
  }
});
```

### Playground v2.5
**Endpoint:** `fal-ai/playground-v25`
**Best For:** Creative, artistic images

```typescript
const result = await fal.subscribe("fal-ai/playground-v25", {
  input: {
    prompt: "A surreal dreamsca