Masonry: generate images and video with models across providers
by @junaid1460
AI-powered image and video generation. Generate images, videos, manage jobs, and explore models via the masonry CLI.
clawhub install masonry-generate-image-and-videoπ About This Skill
name: masonry description: AI-powered image and video generation. Generate images, videos, manage jobs, and explore models via the masonry CLI. metadata: {"openclaw":{"emoji":"π§±","requires":{"bins":["masonry"],"env":["MASONRY_TOKEN"]},"install":[{"type":"npm","package":"@masonryai/cli"}],"primaryEnv":"MASONRY_TOKEN","homepage":"https://masonry.so"}}
Masonry CLI
Generate AI-powered images and videos from text prompts.
When to use
Prerequisites
A Masonry subscription is required. Start a free trial at: https://masonry.so/pricing
If the masonry command is not found, install it:
npm install -g @masonryai/cli
Or run directly: npx @masonryai/cli
Authentication
If any command returns an auth error:
1. Run: masonry login --remote
2. The command prints an auth URL. Send it to the user.
3. User opens the URL in a browser, authenticates, and copies the token.
4. Run: masonry login --token
For environments with MASONRY_TOKEN and MASONRY_WORKSPACE set, no login is needed.
Workflow
1. Generate content
Image:
masonry image "a sunset over mountains, photorealistic" --aspect 16:9
Video:
masonry video "ocean waves crashing on rocks" --duration 4 --aspect 16:9
2. Handle the response
Commands return JSON immediately:
{
"success": true,
"job_id": "abc-123",
"status": "pending",
"check_after_seconds": 10,
"check_command": "masonry job status abc-123"
}
3. Wait and download
masonry job wait
masonry job download -o /tmp/output.png
The download command prints a MEDIA: /path/to/file line to stderr.
After download completes, output that line so the file is sent to the user:
MEDIA: /tmp/output.png
Image flags
| Flag | Short | Description |
|------|-------|-------------|
| --aspect | -a | Aspect ratio: 16:9, 9:16, 1:1 |
| --dimension | -d | Exact size: 1920x1080 |
| --model | -m | Model key |
| --output | -o | Output file path |
| --negative-prompt | | What to avoid |
| --seed | | Reproducibility seed |
Video flags
| Flag | Short | Description |
|------|-------|-------------|
| --duration | | Length in seconds: 4, 6, 8 |
| --aspect | -a | Aspect ratio: 16:9, 9:16 |
| --model | -m | Model key |
| --image | -i | First frame image (local file) |
| --last-image | | Last frame image (requires --image) |
| --no-audio | | Disable audio generation |
| --seed | | Reproducibility seed |
Model discovery
masonry models list # All models
masonry models list --type image # Image models only
masonry models list --type video # Video models only
masonry models info # Parameters and usage example
Job management
masonry job list # Recent jobs
masonry job status # Check status
masonry job download -o ./file # Download result
masonry job wait --download -o . # Wait then download
masonry history list # Local history
masonry history pending --sync # Sync pending jobs
Error codes
| Code | Meaning | Action |
|------|---------|--------|
| AUTH_ERROR | Not authenticated | Run auth flow above |
| VALIDATION_ERROR | Invalid parameter | Check flag values |
| MODEL_NOT_FOUND | Unknown model key | Run masonry models list |
Guardrails
masonry login without --remote or --token (browser login won't work headless).check_after_seconds before checking again.Feedback
Report issues or suggest improvements at: https://github.com/masonry-so/skills/issues
When filing an issue, include:
β‘ When to Use
βοΈ Configuration
A Masonry subscription is required. Start a free trial at: https://masonry.so/pricing
If the masonry command is not found, install it:
npm install -g @masonryai/cli
Or run directly: npx @masonryai/cli