@callirra/cli

Callirra CLI — generate images and video, browse 172 curated prompt recipes, and manage your account from the terminal. One API key for the newest image and video models.

latest

Source

npm

Version: 0.2.0

Version published: 6 days ago

Weekly downloads: 28

Maintainers: 1

Weekly downloads

Created: 3 weeks ago

Source

@callirra/cli

Official Callirra CLI — generate images and videos, browse 172 curated prompt recipes, and manage your account from the terminal. One API key for the newest image and video models.

Example CLI session: balance, generate an image with nano-banana-2, print the creative knowledge base summary and list prompt templates.

Requirements

The built-in template catalogue was retired (Sep 2026), and its commands went with it: the endpoint answers an empty list, so prompt templates and prompt enhance could not work. They are replaced by recipes, recipe <slug> and scenes below, which read a snapshot of our own library shipped in the package.

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

# Templates / knowledge
callirra recipes [--category x] [--limit n]   # Browse the 172-recipe prompt library
callirra recipe <slug>                          # One recipe: prompt, settings, credits, deep link
callirra scenes [slug]                         # The six worked Seedance 2.5 scene recipes
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

GPT Image 2.5 Prompt Atlas — 50 prompts, each shipped with the exact frame it produced, plus a measured Flare-vs-Sunburst comparison
MCP server · Agent skill — the same catalogue for Claude Code, Cursor and Codex

Start free at callirra.com