Masonry CLI

通过文本提示生成 AI 驱动的图像和视频。

适用场景

• 用户希望生成图像或视频
• 用户询问可用的 AI 模型
• 用户希望查询生成任务状态或下载结果
• 用户请求创建视觉内容、媒体或艺术作品

前提条件

需拥有 Masonry 订阅。可在此开启免费试用：https://masonry.so/pricing

若系统未识别 masonry 命令，请先安装：

npm install -g @masonryai/cli

或直接运行：npx @masonryai/cli

身份验证

若任意命令返回认证错误（auth error）：

1. 运行：masonry login --remote
2. 该命令将输出一个认证 URL，请将其发送给用户。
3. 用户在浏览器中打开该 URL，完成身份验证，并复制返回的 token。
4. 运行：masonry login --token

若环境中已设置 MASONRY_TOKEN 和 MASONRY_WORKSPACE 环境变量，则无需额外登录。

工作流程

1. 生成内容

图像：

masonry image "a sunset over mountains, photorealistic" --aspect 16:9

视频：

masonry video "ocean waves crashing on rocks" --duration 4 --aspect 16:9

2. 处理响应

命令会立即返回 JSON 格式响应：

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

3. 等待并下载

masonry job wait 
masonry job download  -o /tmp/output.png

download 命令会在 stderr 中输出一行 MEDIA: /path/to/file。 下载完成后，请输出该行，以便将文件发送给用户：

MEDIA: /tmp/output.png

图像参数标志

视频参数标志

模型发现

masonry models list              # 列出所有模型
masonry models list --type image # 仅列出图像模型
masonry models list --type video # 仅列出视频模型
masonry models info   # 查看模型参数及使用示例

任务管理

masonry job list                          # 查看近期任务
masonry job status                # 查询任务状态
masonry job download  -o ./file   # 下载结果
masonry job wait  --download -o . # 等待完成并下载
masonry history list                      # 查看本地历史记录
masonry history pending --sync            # 同步待处理任务

错误码

安全守则

• 切勿伪造 job ID 或模型 key；始终使用命令实际输出的值。
• 切勿在不带 --remote 或 --token 参数的情况下运行 masonry login（无头环境无法使用浏览器登录）。
• 若任务状态为 pending，请等待响应中指定的 check_after_seconds 秒后再查询状态。
• 所有命令输出均为 JSON 格式；请解析它，不要猜测结构。

反馈

报告问题或提出改进建议，请访问：https://github.com/masonry-so/skills/issues

提交 issue 时，请包含以下信息：

• 您的意图是什么？ 您希望实现什么目标？
• 哪些功能正常？ 哪些部分表现符合预期？
• 哪些方面需要改进？ 出现了什么问题？或哪些地方可以做得更好？