oanim assets <command> [options]
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
--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.
