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

Pass 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. Agents should always use aims login --key — without a key the command exits instead of prompting.

aims login --key aims_xxx

Generate an image

aims image "a red panda astronaut, studio lighting" \
  --model fal-ai/nano-banana-pro \
  --aspect-ratio 16:9 \
  --json

Edit an image (image-to-image)

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

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 \
  --json

Account & discovery

aims whoami --json
aims models --type image --json
aims image "a red panda astronaut" --dry-run --json

Run aims --help or aims <command> --help for examples. Use --json for machine-readable output, --print url to print only result URLs, and --dry-run to preview a request without spending credits.

CLI