CLI

The aims command line

Install once, authenticate with your API key, and generate images and videos straight from your terminal or scripts.

Install

npm install -g @ai-media-studio/cli

Log in

Paste your aims_ key (from Workspace Settings → API Keys). It is stored at ~/.aims/config.json. You can also set AIMS_API_KEY or pass --key per command.

aims login

Generate an image

aims image "a red panda astronaut, studio lighting" \
  --model fal-ai/nano-banana-2 \
  --aspect-ratio 16:9 \
  --output ./out

Edit an image (image-to-image)

aims edit "make it a night scene with neon" \
  --image-url https://example.com/photo.jpg \
  --output ./out

Generate a video

Video credits are charged per second — keep clips short to control cost.

aims video "drone shot over snowy mountains at sunrise" \
  --model fal-ai/veo3.1/fast \
  --duration 6 \
  --output ./out

Account & discovery

aims whoami
aims models --type image
aims models --type video

Run aims --help or aims <command> --help to see every option. Use --json for machine-readable output in scripts.

CLI