用途:从图片中去除背景,只保留前景主体并带透明区域,适合抠图、隔离主体或制作透明素材。
命令:agent-media image remove-background --in <path> [options]
参数:--in 为必填,输入文件路径或 URL;--out 为可选,输出路径、文件名或目录(默认 ./);--provider 为可选,指定提供方 local、fal 或 replicate。
输出:返回 JSON 对象,包含处理后的图片路径,例如 {"ok":true,"media_type":"image","action":"remove-background","provider":"fal","output_path":"nobg_123_abc.png","mime":"image/png","bytes":34567}。
示例:本地文件去背景 agent-media image remove-background --in portrait.jpg;指定提供方 agent-media image remove-background --in portrait.jpg --provider replicate。
提供方:local 在 CPU 上通过 Transformers.js 本地运行,无需 API key,使用 Xenova/modnet 模型,首次使用时下载模型(约 25MB),可能出现 mutex lock failed 错误可忽略,只要 ok 为 true 输出即正确;fal 需要 FAL_API_KEY,使用 birefnet/v2 模型;replicate 需要 REPLICATE_API_TOKEN,使用 birefnet 模型。
限制:具体输出格式与各提供方可用性相关资料未完全展开,未提供的收费、价格、平台与效果信息暂未提供。