Give your AI Agent direct access to Callirra image, video and prompt capabilities
Install the Callirra Skill for Codex, Claude Code, Cursor and other agents. Your agent can discover models, upload references, read credits, create tasks, and fetch results without manual API glue code.
Help me install this skill. Use command `npx skills add callirra-ai/skill --all`. One install unlocks image, video and prompt workflows.
npx skills add callirra-ai/skill --allWorks across the AI tools you already use
Works with Claude Code, Codex, Cursor and other skill-enabled agents, plus MCP clients and terminals.
One skill. Multiple state-of-the-art media models.
Your agent uses one consistent workflow across the full Callirra media stack.
Seedance 2.5
High-quality AI video generation for product promos, story shots, social clips, and ad creative.
GPT Image 2.5
Reliable image generation for covers, posters, product visuals, character work, and marketing assets.
Nano Banana 2
Fast and efficient for batch runs, low-latency workflows, and agent-driven iteration loops.
Seedream 5 Pro
High-quality image model supporting text-to-image and image-to-image workflows.
How it works
You describe the job. The skill handles the execution layer.
1. You give your agent a media task
For example: generate three key visuals, one promo video, and one prompt set.
2. The skill handles the API workflow
Model selection, uploads, balance checks, task creation, and polling all run through the skill.
3. Results return directly to the agent
Your agent gets task status, output URLs, and the next step inside the same context window.
What your agent can produce
From first drafts to final deliverables, without switching tools.
Ecommerce hero images and product assets
Generate product visuals with GPT Image 2.5 / Nano Banana 2.
Brand videos and ad scenes
Produce short videos and ad scenes with Seedance 2.5.
High-volume concept exploration
Iterate across many creative directions with low-cost batch runs.
Prompt library & creative knowledge
Choose from the bundled offline recipe library and build on the curated Creative Knowledge Base.
Manual Install
Use this exact three-step flow: install the skill, configure the API key once, then paste prompts into your agent.
Install (npx skills)
List what can be installed from the repo first, then install everything. If your skills runtime supports agent targeting, you can scope the install to specific agents.
npx skills add callirra-ai/skill --all
Get and configure API key
Get your free API key from Callirra and configure it once. The script stores the key at `~/.config/callirra/api_key`, so you do not need to export it every session.
python3 scripts/callirra_api.py setup-api-key "<your_api_key>"
Use the skill in your agent
Paste these prompts directly into your agent chat, or simply tell your agent to generate images, videos and prompts.
Use $callirra-media-generator-skill to generate one image: - model: nano-banana-2 - prompt: A cinematic product hero shot - return the output image URL.
Other integration options
Skill, MCP and CLI share the same Callirra API.
Callirra Skill
SKILL.md + zero-dependency Python CLI + workflows + Creative Knowledge Base.
npx skills add callirra-ai/skill --allGitHub →Callirra MCP
MCP server with native agent tool calling for Claude Code, Cursor and Codex.
npm install -g @callirra/mcpGitHub →Callirra CLI
Terminal commands for images, videos, balances and task management.
npm install -g @callirra/cliGitHub →FAQ
Which AI agents are supported?▾
The Skill supports Claude Code, Codex, Cursor and other skill-enabled platforms; MCP supports MCP clients; CLI works in any terminal.
Is the skill itself free to install?▾
Yes, it is open source under MIT. Install is free; only actual Callirra model usage consumes credits.
Why use a skill instead of wiring the API manually?▾
The skill already wraps model discovery, uploads, balance checks, task creation, polling and result delivery, so you avoid repeated glue code.
Do I need to manage updates manually?▾
The GitHub repos stay in sync and the install command pulls the latest version; release notes are published on GitHub.
Install the Callirra Skill into your agent now
If you want your assistant to run the full media generation workflow for you, this page gives you the exact setup.