名称： masonry
描述： 使用 Masonry CLI 进行 AI 驱动的图像与视频生成。可生成图像、视频，检查任务状态，并管理媒体资源。
元数据：
author: masonry-ai
version: "1.0"
compatibility: 需要安装 masonry CLI (curl -sSL https://media.masonry.so/cli/install.sh | sh)
允许工具： Bash(masonry:*)

Masonry CLI

masonry CLI 提供了由 AI 驱动的图像与视频生成功能。

何时使用此技能

当用户需要完成以下任务时，可使用此技能：
- 根据文本提示生成图像
- 根据文本提示生成视频
- 检查生成任务的状态
- 下载已生成的媒体文件
- 列出可用的 AI 模型
- 查看生成历史记录

安装

如果系统中没有 masonry 命令，请按以下方式安装：

curl -sSL https://media.masonry.so/cli/install.sh | sh

快速命令

# 生成图像
masonry image "你的提示词" --aspect 16:9

# 生成视频
masonry video "你的提示词" --duration 4

# 检查任务状态
masonry job status <任务ID>

# 下载结果
masonry job download <任务ID> -o ./output.png

# 列出可用模型
masonry models list --type image
masonry models list --type video

详细工作流

图像生成

# 基础生成
masonry image "山峦之上的日落，照片级真实感"

# 带选项生成
masonry image "赛博朋克城市景观" --aspect 16:9 --model imagen-3.0-generate-002

# 可用参数
#   --aspect, -a     宽高比 (16:9, 9:16, 1:1)
#   --dimension, -d  精确尺寸 (1920x1080)
#   --model, -m      模型标识
#   --output, -o     输出路径
#   --negative-prompt 需要避免的内容
#   --seed           可复现性种子

视频生成

# 基础生成
masonry video "海浪拍打岩石"

# 带选项生成
masonry video "森林的无人机航拍镜头" --duration 6 --aspect 16:9

# 可用参数
#   --duration       视频时长（秒）(4, 6, 8)
#   --aspect, -a     宽高比 (16:9, 9:16)
#   --model, -m      模型标识
#   --image, -i      首帧图像
#   --no-audio       禁用音频生成

任务管理

# 列出近期任务
masonry job list

# 检查特定任务
masonry job status <任务ID>

# 等待任务完成并下载
masonry job wait <任务ID> --download -o ./result.png

# 查看本地历史记录
masonry history list
masonry history pending --sync

模型探索

# 列出所有模型
masonry models list

# 按类型筛选
masonry models list --type video

# 获取模型参数
masonry models params veo-3.1-fast-generate-preview

响应格式

所有命令均返回 JSON 格式数据：

{
  "success": true,
  "job_id": "abc-123",
  "status": "pending",
  "check_after_seconds": 10,
  "check_command": "masonry job status abc-123"
}

身份验证

如果命令因身份验证错误而失败，请运行：

masonry login

增强项目技能

如需安装包含详细工作流的项目特定技能，请运行：

masonry skill install

此命令会将附加技能安装到 .claude/skills/ 目录下：
- masonry-generate - 详细的生成工作流
- masonry-models - 模型探索
- masonry-jobs - 任务管理