用途:按指定宽高裁剪图片,并以可配置焦点为中心计算裁剪区域,同时保持在图像边界内。适合提取图像局部、制作自定义定位的缩略图。
主要能力:可设置裁剪宽度与高度;通过焦点坐标控制裁剪中心;支持设置输出 DPI;支持指定输出路径;可选择 provider,默认使用本地 local(基于 Sharp 库,无需 API 密钥)。
用法:命令为 npx agent-media@latest image crop --in <path> --width <px> --height <px> [options]。--in 必填,输入文件路径或 URL;--width 必填,裁剪区域宽度(像素);--height 必填,裁剪区域高度(像素);--focus-x 可选,焦点 X 位置 0-100,默认 50 即居中;--focus-y 可选,焦点 Y 位置 0-100,默认 50;--dpi 可选,输出 DPI/密度,默认 300;--out 可选,输出路径、文件名或目录,默认 ./;--provider 可选,默认 local。输出返回 JSON 对象,含裁剪后图片路径及 media_type、action、provider、output_path、mime、bytes 等字段。
限制:资料仅提及 local 为默认 provider,其他 provider 未提供具体信息;未说明支持的全部图片格式、最大尺寸、收费情况,暂未提供。