fal-text-to-video

What this skill does

## Quick Reference

| Model | Endpoint | Duration | Audio | Speed |
|-------|----------|----------|-------|-------|
| Kling 2.6 Pro | `fal-ai/kling-video/v2.6/pro/text-to-video` | 5-10s | Yes | Slow |
| Sora 2 | `fal-ai/sora` | 5-20s | Optional | Slow |
| LTX-2 Pro | `fal-ai/ltx-2-pro` | 5s | Yes | Medium |
| Runway Turbo | `fal-ai/runway-gen3/turbo/text-to-video` | 5-10s | No | Fast |
| Luma | `fal-ai/luma-dream-machine` | 5s | No | Medium |

| Aspect Ratio | Value | Use Case |
|--------------|-------|----------|
| Landscape | `"16:9"` | Standard video |
| Portrait | `"9:16"` | Social/mobile |
| Square | `"1:1"` | Social posts |

| Prompt Structure | Example |
|------------------|---------|
| Subject + Action | "A woman walks" |
| + Setting | "through a forest" |
| + Style | "cinematic lighting" |
| + Camera | "tracking shot" |

## When to Use This Skill

Use for **text-to-video generation**:
- Creating videos from text descriptions
- Choosing models by quality/speed tier
- Crafting motion-oriented prompts
- Generating videos with native audio
- Preview workflow (fast) → Final (quality)

**Related skills:**
- For image-to-video: see `fal-image-to-video`
- For video editing: see `fal-video-to-video`
- For model comparison: see `fal-model-guide`

---

# fal.ai Text-to-Video Models

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

## Kling Video Models

### Kling 2.0 Standard
**Endpoint:** `fal-ai/kling-video/v2.0/text-to-video`
**Best For:** Good quality, cost-effective

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

const result = await fal.subscribe("fal-ai/kling-video/v2.0/text-to-video", {
  input: {
    prompt: "A majestic eagle soaring over snow-capped mountains at golden hour, cinematic lighting",
    duration: "5",  // "5" or "10" seconds
    aspect_ratio: "16:9",
    negative_prompt: "blurry, distorted, low quality"
  }
});

console.log(result.video.url);
```

```python
import fal_client

result = fal_client.subscribe(
    "fal-ai/kling-video/v2.0/text-to-video",
    arguments={
        "prompt": "A majestic eagle soaring over mountains",
        "duration": "5",
        "aspect_ratio": "16:9",
        "negative_prompt": "blurry, distorted"
    }
)
print(result["video"]["url"])
```

### Kling 2.5 Pro
**Endpoint:** `fal-ai/kling-video/v2.5/pro/text-to-video`
**Best For:** Professional quality videos

```typescript
const result = await fal.subscribe("fal-ai/kling-video/v2.5/pro/text-to-video", {
  input: {
    prompt: "A luxury car driving through a mountain road, drone shot, cinematic",
    duration: "5",
    aspect_ratio: "16:9",
    negative_prompt: "shaky, amateur, blurry"
  }
});
```

### Kling 2.6 Pro (Latest)
**Endpoint:** `fal-ai/kling-video/v2.6/pro/text-to-video`
**Best For:** Highest quality with native audio generation

The latest Kling model with built-in audio generation.

```typescript
const result = await fal.subscribe("fal-ai/kling-video/v2.6/pro/text-to-video", {
  input: {
    prompt: "Ocean waves crashing on rocky cliffs at sunset, seagulls flying, ambient sounds",
    duration: "5",
    aspect_ratio: "16:9",
    negative_prompt: "static, boring, low quality"
  }
});

console.log(result.video.url);
console.log(result.audio?.url);  // Native audio included
```

**Kling Parameters:**

| Parameter | Type | Values | Description |
|-----------|------|--------|-------------|
| `prompt` | string | - | Video description |
| `duration` | string | "5", "10" | Duration in seconds |
| `aspect_ratio` | string | "16:9", "9:16", "1:1" | Video dimensions |
| `negative_prompt` | string | - | What to avoid |

## Sora 2

### Sora (OpenAI)
**Endpoint:** `fal-ai/sora`
**Best For:** Advanced, creative video generation

```typescript
const result = await fal.subscribe("fal-ai/sora", {
  input: {
    prompt: "A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage. She wears a black leather jacket, a long red dress, and black boots. She carries a black purse. She wears sunglasses and red lipstick. She walks confidently. The street is damp and reflective, creating a mirror effect of the colorful lights.",
    duration: 10,
    aspect_ratio: "16:9",
    resolution: "1080p"
  }
});

console.log(result.video.url);
```

**Sora Parameters:**

| Parameter | Type | Values | Description |
|-----------|------|--------|-------------|
| `prompt` | string | - | Detailed video description |
| `duration` | number | 5-20 | Duration in seconds |
| `aspect_ratio` | string | "16:9", "9:16", "1:1" | Video dimensions |
| `resolution` | string | "720p", "1080p" | Output resolution |

## LTX Video Models

### LTX Video (Original)
**Endpoint:** `fal-ai/ltx-video`
**Best For:** Fast, efficient generation

```typescript
const result = await fal.subscribe("fal-ai/ltx-video", {
  input: {
    prompt: "A beautiful sunset over the ocean with gentle waves",
    negative_prompt: "low quality, blurry, distorted",
    num_inference_steps: 30,
    guidance_scale: 7.5,
    aspect_ratio: "16:9"
  }
});
```

### LTX Video v2
**Endpoint:** `fal-ai/ltx-video/v2`
**Best For:** Improved quality over v1

```typescript
const result = await fal.subscribe("fal-ai/ltx-video/v2", {
  input: {
    prompt: "A futuristic city with flying cars and neon lights",
    negative_prompt: "ugly, distorted",
    num_inference_steps: 35,
    guidance_scale: 7.0,
    resolution: "720p"
  }
});
```

### LTX-2 Pro
**Endpoint:** `fal-ai/ltx-2-pro`
**Best For:** High fidelity with audio support

```typescript
const result = await fal.subscribe("fal-ai/ltx-2-pro", {
  input: {
    prompt: "A jazz band performing in a dimly lit club, smooth music, intimate atmosphere",
    negative_prompt: "worst quality, inconsistent motion, blurry",
    num_inference_steps: 30,
    guidance_scale: 3.5,
    resolution: "720p",
    enable_audio: true  // Generate matching audio
  }
});

console.log(result.video.url);
console.log(result.audio?.url);  // Audio track if enabled
```

**LTX Parameters:**

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `prompt` | string | - | Video description |
| `negative_prompt` | string | - | What to avoid |
| `num_inference_steps` | number | 30 | Quality steps |
| `guidance_scale` | number | 7.5 | Prompt adherence |
| `resolution` | string | "720p" | "720p" or "480p" |
| `aspect_ratio` | string | "16:9" | Video dimensions |
| `enable_audio` | boolean | false | Generate audio (LTX-2 Pro) |

## Wan Video

### Wan v2.1 1.3B
**Endpoint:** `fal-ai/wan/v2.1/1.3b/text-to-video`
**Best For:** Lightweight, fast generation

```typescript
const result = await fal.subscribe("fal-ai/wan/v2.1/1.3b/text-to-video", {
  input: {
    prompt: "A cat playing with a ball of yarn, cute, playful",
    num_frames: 81,  // Number of frames
    resolution: "480p"
  }
});
```

### Wan v2.1 14B
**Endpoint:** `fal-ai/wan/v2.1/14b/text-to-video`
**Best For:** Higher quality, larger model

```typescript
const result = await fal.subscribe("fal-ai/wan/v2.1/14b/text-to-video", {
  input: {
    prompt: "A professional chef preparing sushi, precise movements, high-end restaurant",
    num_frames: 81,
    resolution: "720p"
  }
});
```

## MiniMax Video

### MiniMax Text-to-Video
**Endpoint:** `fal-ai/minimax-video/text-to-video`
**Best For:** Balanced quality and speed

```typescript
const result = await fal.subscribe("fal-ai/minimax-video/text-to-video", {
  input: {
    prompt: "A butterfly emerging from a cocoon, macro shot, nature documentary style",
    prompt_optimizer: true  // Enhance prompt automatically
  }
});
```

**MiniMax Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `prompt` | string | Video description |
| `prompt_optimizer` | boolean | Auto-enhance prompt |

## Runway Gen-3

### Runway Gen-3 Turbo
**Endpoint:** `fal-ai/runway-gen3/turbo/text-to-video`
**Best For:** Fast iteration, previews

```typescript
const result = await fal.subscribe("fal-ai/runway-gen3/tur