- name
- audio-to-video
- description
- Generate video from audio + image using fal.ai LTX-2.5 Pro. Use for: talking head, lip sync, audio-driven video.
- allowed-tools
- Bash, Read, Write
# Audio to Video — LTX 2.5 Pro
Generate video from audio using fal.ai LTX-2.5 Pro (`lightricks/ltx-2.5/audio-to-video/pro`).
## Usage
```bash
cd /Users/aviz/.claude/skills/audio-to-video/scripts
npx ts-node generate.ts \
--audio "/path/to/audio.mp3" \
--image "/path/to/frame.jpg" \
-d /tmp/output.mp4 \
"Cinematic description of motion and action"
```
## Flags
| Flag | Description |
|------|-------------|
| `--audio`, `-a` | Audio file (mp3/wav/ogg/m4a/aac) — **Pro max 10 seconds** |
| `-d`, `--destination` | Output video path (required) |
| `--image`, `-i` | Starting frame image (highly recommended) |
| `--end-image` | Ending frame image (image-to-video only) |
| `--size`, `-s` | Video size (see below) |
| `--fps` | Frames per second (24/25) — image-to-video only |
| `--quality` | low=720p, high=1080p — image-to-video only |
| `--guidance-scale` | Default: 9 with image, 5 without |
## Endpoints (LTX 2.5)
| Mode | Endpoint |
|------|----------|
| Audio + (optional image) | `lightricks/ltx-2.5/audio-to-video/pro` |
| Image only (no audio) | `lightricks/ltx-2.5/image-to-video/pro` |
Script auto-selects based on whether `--audio` is provided.
## Video Sizes
`landscape_16_9` (default), `portrait_16_9`, `landscape_4_3`, `square_hd`, `auto`
## Audio Limit
**Pro max 10 seconds per clip** (API range 2–20s, Pro caps at 10). Split longer shots.
## API Key
Uses `FAL_KEY` from `~/.claude/skills/image-generation/scripts/.env`
## Writing Strong Prompts
The prompt drives video motion. Include:
1. **Subject action** — what is moving and how ("singer throwing head back mid-note")
2. **Camera movement** — "slow dolly in", "whip pan", "handheld shake"
3. **Lighting event** — "strobe burst", "spotlight sweep", "laser beams"
4. **Emotion/energy** — "euphoric", "intense", "raw power"
5. **Environment** — "fog rolling across stage", "confetti mid-air"
Example:
```
"LIVE ARENA CONCERT: Female singer throwing head back mid-high-note, hair arcing in slow motion.
Camera: slow push in. Lighting: single white spotlight with rim halo.
Fog at feet, pure emotional catharsis. Hyper-real 4K cinema"
```
Voir sur GitHub