用途:image-extend 用于在图像四周添加纯色内边距以扩展画布,适合需要加边框、留白或扩大画布的场景。它由本地处理完成,无需 API 密钥,底层使用 Sharp。
主要能力:向图片四边填充指定像素宽度的纯色背景并输出新的图像文件;填充色使用十六进制颜色,并会同时压平透明区域;可指定输出图像的 DPI 密度。
使用方式:通过命令行调用 agent-media image extend --in <path> --padding <pixels> --color <hex> [options]。其中 --in 为必填,表示输入文件路径或 URL;--padding 为必填,表示四边各自添加的像素宽度;--color 为必填,表示扩展区域的背景色(如 "#FFFFFF");--dpi 可选,默认 300;--out 可选,默认 ./。
输出:返回 JSON 对象,包含成功标记、媒体类型、动作、提供方、输出路径、MIME 类型与字节数等信息。
适用场景:为照片或插画添加白色或彩色边框;为打印准备文件时扩大画布并设定 DPI。限制:填充仅支持纯色,且会压平透明通道;填充宽度四边相同,无法单独指定每条边;暂未提供其他复杂扩展、内容生成或非本地处理方式。