用途:通过官方 @transloadit/node 命令行,对一张本地输入图片做一次性背景移除,生成带透明通道的 PNG 文件。
主要能力:使用最小化步骤 JSON 调用 /image/bgremove 机器人完成去背景,并下载结果到指定路径。步骤定义需为扁平对象(以步骤名为键),不要把内容包在顶层 "steps" 键下。参考步骤:
{
":original": {
"robot": "/upload/handle"
},
"background_removed": {
"use": ":original",
"robot": "/image/bgremove",
"format": "png",
"result": true
}
}
输入:本地输入图片的绝对路径;可选输出路径,默认给出明确的同级 .png 文件。
凭证解析顺序:Shell 环境变量,其次当前工作目录的 .env(仅当前目录),最后 ~/.transloadit/credentials。若 .env 位于上级目录,需先把变量导出到 shell。作为可复用的用户级配置,优先使用 ~/.transloadit/credentials;当前目录 .env 优先级更高,若需确定性选择账号应避免使用它。若凭证只在仓库根 .env 中,需在该目录运行命令或先导出变量。
使用方式:在当前工作目录创建 steps.json,然后运行:
npx -y @transloadit/node assemblies create
--steps ./steps.json
-i ./input/source.jpg
-o ./out/result.png
将输入路径替换为真实图片路径。命令结束后确认输出 PNG 存在于预期路径。
调试:失败时可运行 npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j
限制与注意事项:保持 format 为 "png" 以保留透明度;输出建议使用明确的 PNG 文件名(如 ./out/result.png),当前 CLI 对单结果使用目录输出可能保留输入路径而非给出 .png 文件名。去背景质量取决于源图,建议使用前景主体清晰的照片。收录资料未提供价格、平台与更多步骤参数说明。