oanim assets

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.

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.

Image commands

gen-image

Generate an image from a text prompt.

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.

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.

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.

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.

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

# 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

# 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

# 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 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 for current model costs.

Getting Started

CLI

Reference

Guides

Image commands

gen-image

edit-image

remove-bg

upscale

run — any model

Video generation

Audio generation

Other models

When to use each command

Supported models

Highlights

Tips

Pricing

​Image commands

​gen-image

​edit-image

​remove-bg

​upscale

​run — any model

​Video generation

​Audio generation

​Other models

​When to use each command

​Supported models

​Highlights

​Tips

​Pricing

Image commands

gen-image

edit-image

remove-bg

upscale

run — any model

Video generation

Audio generation

Other models

When to use each command

Supported models

Highlights

Tips

Pricing