@callirra/cli

@callirra/cli

Official Callirra CLI — generate images and videos, use Prompt Studio templates, check balance and manage tasks from your terminal.

Requirements

• Node.js 22+
• A Callirra API key (sk-cal-...)

Install

npm install -g @callirra/cli
# or
pnpm add -g @callirra/cli

Get an API key at callirra.com, then save it once:

callirra setup-api-key sk-cal-xxxxxxxxxxxxxxxx

Quick start

callirra models
callirra gen image "A cinematic product hero shot" --model nano-banana-2 --out hero.png
callirra gen video "A drone shot over mountains" --model seedance-2.5 --duration 10 --wait --out clip.mp4

Commands

# Account
callirra setup-api-key <key>       # Save API key locally
callirra whoami                    # Show configured key + balance
callirra balance                   # Show balance and available credits
callirra usage --limit 10          # Show recent usage

# Models / media
callirra models                    # List available models
callirra gen image <prompt>        # Generate an image
callirra gen video <prompt>        # Create a video task
callirra videos [--limit 20]      # List recent video tasks
callirra task <id>                 # Show task status
callirra cancel <id>               # Cancel a task

# Prompt Studio / knowledge
callirra prompt templates          # List built-in templates
callirra prompt enhance <id> <text> [--kind video|image] [--language zh|en]
callirra creative [--full]         # Show creative knowledge summary or full JSON
callirra upload ./frame.png --content-type image/png  # Upload reference image

gen image

callirra gen image "A cinematic product hero shot" \
  --model nano-banana-2 \
  --size 1024x1024 \
  --out hero.png

Options: --model, --size, --n, --out, --reference <url1,url2>, --image-input <url>, --nsfw-checker, --google-search.

gen video

callirra gen video "A drone shot over mountains" \
  --model seedance-2.5 \
  --duration 10 \
  --resolution 720p \
  --mode text_to_video \
  --generate-audio \
  --wait \
  --out clip.mp4

Options: --model, --duration, --resolution, --mode, --aspect-ratio, --generate-audio, --frame-image <url1,url2>, --input-reference <url1,url2>, --input-images <url1,url2>, --input-videos <url>, --audio-input <url1,url2,url3>, --seed <n>, --seedance-mode, --kling-mode, --minimax-mode, --camera-fixed, --kling-orientation, --background-source, --output-format mp4|mov, --return-last-frame, --audio-setting auto|origin, --nsfw-checker, --google-search, --wait, --out.

Configuration

Variable	Default
CALLIRRA_API_KEY	Required unless key is saved
CALLIRRA_API_BASE	https://api.callirra.com

Saved key location: ~/.config/callirra/api_key.

License

MIT. Source: github.com/callirra-ai/cli

Start free at callirra.com