Callirra Media Generator Skill

⚠️ The built-in template catalogue and the enhance flow were retired (Sep 2026) and are not coming back. PROMPT_TEMPLATES is an empty array, GET /api/v1/prompts/templates answers an empty list, and POST /v1/prompts/enhance needs a templateId that no longer exists — it answers 404.

The bundled recipe library replaces them — offline, no key: recipes, recipe <slug>, scenes.

An open-source AI agent skill for generating and monitoring Callirra image and video tasks.

Works with Claude Code, Codex, Cursor and other skill-enabled AI coding platforms.

Requirements

• Python 3.10+
• A Callirra API key (sk-cal-...)

Install

Install the skill into your agent runtime:

npx skills add callirra-ai/skill --all

Then save your API key once:

python3 scripts/callirra_api.py setup-api-key "<your-api-key>"

Get a key at callirra.com.

Commands

# Account
python3 scripts/callirra_api.py balance
python3 scripts/callirra_api.py usage --limit 10

# Models
python3 scripts/callirra_api.py models

# Prompt library (bundled with the skill — offline, no key needed)
python3 scripts/callirra_api.py recipes
python3 scripts/callirra_api.py recipe bridge-pursuit-headlights
python3 scripts/callirra_api.py scenes
python3 scripts/callirra_api.py scenes wedding

# Creative knowledge (add --full to print the whole JSON)
python3 scripts/callirra_api.py creative
python3 scripts/callirra_api.py creative --full

# Generate
python3 scripts/callirra_api.py generate-image \
  --model nano-banana-2 \
  --prompt "A cinematic hero shot" \
  --size 1024x1024 \
  --out hero.png

python3 scripts/callirra_api.py generate-video \
  --model seedance-2.5 \
  --prompt "A drone shot over mountains" \
  --duration 10 \
  --resolution 720p \
  --wait \
  --out clip.mp4

# Task management
python3 scripts/callirra_api.py task <TASK_ID>
python3 scripts/callirra_api.py cancel <TASK_ID>

# Upload reference image
python3 scripts/callirra_api.py upload --file ./frame.png --content-type image/png

Content

• SKILL.md — main skill instructions
• scripts/callirra_api.py — zero-dependency Python CLI
• references/callirra-api-reference.md — API reference
• references/creative-knowledge.json — full curated creative knowledge base (110 resources, 8 categories, 39 styles, 61 cinematography terms)
• workflows/ — reusable recipe workflows

Related

• GPT Image 2.5 Prompt Atlas — 50 prompts, each shipped with the exact frame it produced, plus a measured Flare-vs-Sunburst comparison
• CLI · MCP server — the same catalogue for terminals and MCP-compatible agents

License

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

---

Start free at callirra.com