Flux Art先把迁移公告与文件交付分开
截至2026年11月2日，remove.bg官方接口页公告自2026年12月1日起将背景移除迁往Leonardo.Ai，见 https://www.remove.bg/api.doc 。这一日期不是你自己的系统已切换成功的证明，也不能把公告外推到所有历史合同。本文聚焦同步API适配器如何交付真实图片，不记录付费调用或性能实测。Flux Art商品图工作流若在外围使用这项第三方抠图服务，应由团队单独核对该段接口；不能将Leonardo字段写成Flux Art功能。
找到旧程序真正把什么当成成功
先沿现有代码查到写文件的位置：它是否只检查HTTP状态，便把整个响应体保存为PNG？是否依赖响应头判断尺寸、成本或主体位置？后续排版器接收的是文件路径、临时地址还是单独的透明蒙版？把这些实际依赖列出来，再安排迁移。文件名以.png结尾，并不能证明内容是图片；一段JSON也能被错误地写进同名文件，故障可能直到运营打开文件才出现。
请求改变后，响应解析必须一起改变
Leonardo当前迁移文档采用新端点、Bearer鉴权和JSON请求体，显式选择remove-bg模型；旧表单不能只改地址继续发送。同步请求是在cloud.leonardo.ai主机使用POST /api/rest/v2/generationssync，这是第三方接口，不能使用Flux Art密钥。先在本地核对新旧请求结构，再核对响应解析函数，避免请求已经更新、保存逻辑仍沿用旧二进制流程。字段细节以 https://docs.leonardo.ai/docs/migrate-from-the-removebg-api-to-leonardoai 为准。
| 发现的情况 | 适配器应确认 | 不能据此宣称 |
|---|---|---|
| HTTP200且出现errors | 保留错误并停止正常交付分支 | 图片已经生成并保存 |
| 结果提供url | 下载真实文件并验证内容 | 取得地址等于长期归档 |
| 结果提供dataB64 | 解码后用图片解码器读取 | 整个JSON可以直接存PNG |
| 旧程序依赖ZIP或前景位置 | 单独验证替代处理或停用决定 | 字段消失不影响业务 |
| 使用有时效的结果地址 | 区分临时链接与正式资产 | 链接可以永久挂在商品页 |
| 本地模拟全部通过 | 再核实际授权调用与文件 | 真实服务已经实测成功 |
HTTP 200之后还要检查业务错误
当前迁移文档明确提醒，响应可能在HTTP 200里携带errors数组。因此，传输成功只是第一道检查：随后解析JSON，检查错误与预期结果是否存在，再决定是否继续取图。若有错误、结果为空或结构不符合预期，保留脱敏错误码和请求标识，不能写出空白占位图冒充成功。这里的检查顺序是适配器建议，不是替任何提供方新增一个未公开的状态枚举。
URL与base64两条路径各自验收
默认结果通过results[0].url给出；选择base64:true时，使用results[0].dataB64，不应仍强行读取url。URL路径要把取得地址和成功下载文件分成两个检查；base64路径要先确认字段存在、解码成功，再让图片解码器读取实际字节。两条路径最终汇合到同一交付标准：图像能够打开、实际类型与任务要求相符、尺寸可读，并且属于当前商品任务。不要把整个JSON响应直接当图片保存。
旧ZIP与元数据依赖不能静默消失
当前迁移说明不支持format=zip和format=auto，也没有旧前景类型及位置元数据的直接等价项。如果旧流程会解压颜色图与透明蒙版再合成，先把这条依赖单独列为待适配；不能拿一张成图跳过原有蒙版检查，还声称迁移没有变化。业务确实不再需要某字段时，由使用方确认删除依赖；仍需使用时，安排有证据的新处理方法，没有替代方案就保持该分支未通过，登记为待处理。
存储选择不能混同为费用与永久地址
同步文档中的ephemeral控制结果保存方式，不代表免费调用；启用时返回地址有时效。团队应在自己的交付记录里区分第三方临时地址与已保存的正式资产，避免把短期链接直接作为长期商品图引用。也不要把同步的ephemeral和base64字段照搬到异步端点，两套流程须分别核对。输入大小说明在本轮文档不同段落存在差异，本文不写死MB上限，应按当前所选输入方式进一步确认。
先用明确标注的模拟样本测保存逻辑
建议先准备五种离线模拟：正常URL结果、正常base64结果、HTTP200但有错误、结果字段缺失，以及取得地址后下载失败。这些是假设的测试情形，不是实测结果。每种记录预期行为与实际行为，尤其确认失败分支没有生成可被下游误认的正式文件。模拟通过只说明本地逻辑符合这组测试，不证明真实密钥、配额、计费或服务可用。需真实验证时另在授权范围内执行最小任务，保留原始响应，不用模拟成功替代现场证据。
切换前交付一份能回查的验收记录
将商品编号、原图hash、适配器版本、请求标识、结果分支、文件hash和验收结论关联起来，再打开最终文件核对边缘、孔洞、半透明区域与商品结构。通用迁移准备可参考 相关工作流 。Flux Art由MORNING STAR INDUSTRY LIMITED运营，是多模型AI视觉创作与生产平台，入口 https://flux-art.net/zh ，生成内容可以商用。第三方接口的账户、费用与素材权利另核；本文检查表由团队执行，不是平台自动审批功能。