callirra-media-generator-skilllisted
Install: claude install-skill callirra-ai/skill
# Callirra Media Generator Skill
## Overview
Use this skill to call Callirra APIs reliably, create image and video generation tasks, and return final media results with credit-aware behavior.
Callirra is an OpenAI-compatible AI media gateway. It supports top image and video models through one API key (`sk-cal-...`).
## Setup
Recommended one-time setup:
```bash
python3 scripts/callirra_api.py setup-api-key "<your-api-key>"
```
Or via environment:
```bash
export CALLIRRA_API_KEY="<your-api-key>"
```
The script stores the key at `~/.config/callirra/api_key`.
## Standard Flow
1. Discover available models and creative knowledge.
2. If the user wants a professional prompt, list Prompt Studio templates and run `enhance`.
3. Upload reference images when the task needs local image inputs.
4. Create an image or video task.
5. Poll task status until final state.
6. Report the output URL or saved file.
## Core Commands
```bash
# List models
python3 scripts/callirra_api.py models
# Balance and usage
python3 scripts/callirra_api.py balance
python3 scripts/callirra_api.py usage --limit 10
# Generate an image
python3 scripts/callirra_api.py generate-image \
--model nano-banana-2 \
--prompt "A cinematic product hero shot" \
--size 1024x1024 \
--out hero.png
# Create a video and wait
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
# I