> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-animate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# oanim assets

> Generate images, video, audio, and more with AI

```bash theme={null}
oanim assets <command> [options]
```

Generate and manipulate media using AI models routed through the Open Animate media gateway. Supports 25+ models for image generation, video generation, audio, upscaling, and more.

<Note>
  Asset commands require authentication. Run `oanim login` to sign in, or set `ANIMATE_API_KEY`. You can also set `ANIMATE_FAL_KEY` to use your own fal.ai key directly.
</Note>

## Image commands

### gen-image

Generate an image from a text prompt.

```bash theme={null}
oanim assets gen-image --prompt "dark abstract gradient with purple and blue tones, 16:9" --out public/bg.png
```

| Flag              | Required | Description                                    |
| ----------------- | -------- | ---------------------------------------------- |
| `--prompt <text>` | Yes      | Image generation prompt                        |
| `--out <path>`    | Yes      | Output file path                               |
| `--model <id>`    | No       | Override model (default: `fal-ai/flux-2-flex`) |

### edit-image

Edit an existing image with a text prompt.

```bash theme={null}
oanim assets edit-image --in public/bg.png --prompt "add subtle grid pattern" --out public/bg-grid.png
```

| Flag              | Required | Description                                         |
| ----------------- | -------- | --------------------------------------------------- |
| `--in <path>`     | Yes      | Input image path                                    |
| `--prompt <text>` | Yes      | Edit prompt                                         |
| `--out <path>`    | Yes      | Output file path                                    |
| `--model <id>`    | No       | Override model (default: `fal-ai/flux-pro/kontext`) |

### remove-bg

Remove the background from an image.

```bash theme={null}
oanim assets remove-bg --in public/product.png --out public/product-cutout.png
```

| Flag           | Required | Description                                 |
| -------------- | -------- | ------------------------------------------- |
| `--in <path>`  | Yes      | Input image path                            |
| `--out <path>` | Yes      | Output file path                            |
| `--model <id>` | No       | Override model (default: `fal-ai/birefnet`) |

### upscale

Upscale an image 2x.

```bash theme={null}
oanim assets upscale --in public/logo-small.png --out public/logo-2x.png
```

| Flag           | Required | Description                                              |
| -------------- | -------- | -------------------------------------------------------- |
| `--in <path>`  | Yes      | Input image path                                         |
| `--out <path>` | Yes      | Output file path                                         |
| `--model <id>` | No       | Override model (default: `fal-ai/bria/upscale/creative`) |

## run — any model

Run any fal.ai model directly. This is how you access video generation, audio generation, and any other model not covered by the dedicated commands above.

```bash theme={null}
oanim assets run --model <model-id> --input '<json>' [--out <path>]
```

| Flag             | Required | Description                 |
| ---------------- | -------- | --------------------------- |
| `--model <id>`   | Yes      | fal.ai model ID             |
| `--input <json>` | Yes      | JSON input for the model    |
| `--out <path>`   | No       | Download result URL to file |

### Video generation

```bash theme={null}
# Generate a video with Kling 2.5 Turbo Pro
oanim assets run \
  --model fal-ai/kling-video/v2.5-turbo/pro/text-to-video \
  --input '{"prompt": "a slow zoom into a neon city at night"}' \
  --out public/city.mp4

# Generate with Veo 3.1 (Google's best, supports audio)
oanim assets run \
  --model fal-ai/veo3.1 \
  --input '{"prompt": "camera slowly pans across a mountain landscape at sunrise"}' \
  --out public/landscape.mp4

# Other video models: kling-video/v3/pro, minimax/hailuo-02, sora-2/text-to-video/pro
```

### Audio generation

```bash theme={null}
# Generate music with Beatoven
oanim assets run \
  --model beatoven/music-generation \
  --input '{"prompt": "upbeat electronic background music, 120 bpm", "duration_in_seconds": 15}' \
  --out public/music.mp3

# Generate sound effects
oanim assets run \
  --model beatoven/sound-effect-generation \
  --input '{"prompt": "whoosh transition sound effect"}' \
  --out public/whoosh.mp3
```

### Other models

```bash theme={null}
# ControlNet
oanim assets run \
  --model fal-ai/flux/dev/controlnet \
  --input '{"prompt": "...", "control_image_url": "https://..."}' \
  --out public/controlled.png

# IP Adapter (style transfer)
oanim assets run \
  --model fal-ai/flux/dev/ip-adapter \
  --input '{"prompt": "...", "ip_adapter_image_url": "https://..."}' \
  --out public/styled.png

# LoRA
oanim assets run \
  --model fal-ai/lora \
  --input '{"prompt": "...", "lora_url": "https://..."}' \
  --out public/lora.png
```

If `--out` is provided and the model returns a URL, the file is downloaded. Otherwise the raw JSON response is printed to stdout.

## When to use each command

| Scenario                          | Command                      |
| --------------------------------- | ---------------------------- |
| Background textures or gradients  | `gen-image`                  |
| Product screenshots with edits    | `edit-image`                 |
| Product photos for compositing    | `remove-bg`                  |
| Low-res logos or icons            | `upscale`                    |
| Video clips for compositions      | `run` with a video model     |
| Background music or sound effects | `run` with a music/SFX model |
| Any other fal.ai model            | `run`                        |

## Supported models

25+ models across image, video, audio, and more. See [Credits & Billing](/platform/credits-and-billing) for the full model list and per-operation costs.

### Highlights

| Category           | Models                                                                    |
| ------------------ | ------------------------------------------------------------------------- |
| Image generation   | Flux Schnell, Flux 2 Flex, Recraft V4, Ideogram V3, Nano Banana 2         |
| Image editing      | Flux Kontext Pro, Nano Banana 2 Edit, Reve Edit                           |
| Video generation   | Kling V3 Pro, Kling 2.5 Turbo Pro, MiniMax Hailuo-02, Veo 3.1, Sora 2 Pro |
| Audio              | Beatoven Music, Beatoven SFX, MiniMax Speech-02 HD                        |
| Upscaling          | BRIA Creative, Topaz Upscale                                              |
| Background removal | BiRefNet, BRIA RMBG 2.0                                                   |
| Other              | ControlNet, IP Adapter, LoRA                                              |

## Tips

* Generate backgrounds at your video resolution (1920x1080 by default)
* Use `staticFile()` in Remotion to reference files in `public/`
* Remove backgrounds on product shots so they composite cleanly over gradient backgrounds
* Generate short video clips with Kling/Veo and composite them into your Remotion project
* Use Beatoven for background music, then add it with Remotion's `<Audio>` component

## Pricing

Asset generation is billed per operation. See [Credits & Billing](/platform/credits-and-billing) for current model costs.
