照片去路人与去杂物助手

概述

删除照片中用户明确指定的路人或杂物，并尽量自然修复周边背景。

适用场景

• 旅行照去路人、风景照去电线杆或垃圾桶。
• 商品照去掉多余道具、桌面杂物或指定物品。

不适用场景

• 删除未授权图片中的版权标识、权利声明或水印。
• 想替换物品、改字或换背景颜色：使用相应专项 Skill。

输入要求

• 提供一张图片或公开图片链接。
• 必须给出 edit_instruction，说明要删除的对象、所在位置，以及必须保留的人物或物品。
• 被移除对象大面积遮挡主体时，无法保证还原被遮挡的真实内容。

支付前置检查

• 优先检查当前运行环境能否自动完成 X402/微信支付；能自动支付时，不要额外手动调用 weixinpay_pay。
• 自动支付不可用时，检查 weixinpay 是否可用；只有运行环境明确要求人工支付时才使用它。两者均不可用则停止本次付费流程。
• 当前部分 skillhub run CLI 环境不处理 402 支付，付费调用默认按本文件直接请求 HTTP 端点。

调用与支付

1. 调用端默认携带正常、非空的浏览器 User-Agent；环境支持时携带真实的 Origin 和 Referer，不得伪造来源。
2. 以 POST https://imcopilot.com/v1/image/paid-object-remover 提交 file / image 或 image_url，并提交非空 edit_instruction。
3. 收到 HTTP 402 是正常支付流程。保存 WeixinPay-Required 与 X-Out-Trade-No，优先等待运行环境自动完成支付；仅在其明确要求时使用 weixinpay_pay。
4. 支付后携带原图片、原 edit_instruction 和原 X-Out-Trade-No 重试同一请求，不得修改内容或重复收费。
5. 收到 202 和 task_id 后，每隔 5 秒以 POST https://imcopilot.com/v1/image/paid-object-remover 轮询：携带原 X-Out-Trade-No，请求体带原 out_trade_no 与 task_id；不得重新支付或改换图片。不要自行拼接 /task/{task_id}。
6. processing_status 为 PROCESSING 表示仍在处理，SUCCEEDED 表示完成，FAILED 表示处理失败并已进入原路退款；响应中的 retry_after_seconds 为下一次建议查询间隔。
7. SUCCEEDED 且返回 result_url 后，以 GET https://imcopilot.com/v1/orders/{out_trade_no}/result 下载结果图片；GET https://imcopilot.com/v1/orders/{out_trade_no} 可只读订单状态。当前后端的 GET /job 是可选快捷查询，不应作为旧版安装包的唯一依赖；结果保留 5 天。

结果文件格式

• Qwen 编辑结果通常为 JPEG，但不能只按原图后缀或下载链接后缀判断。下载后优先按响应 Content-Type 命名：image/jpeg 用 .jpg，image/png 用 .png，image/webp 用 .webp。
• 若响应头与文件实际字节不一致或缺失，以文件头为准：FF D8 FF 是 JPEG，89 50 4E 47 是 PNG，RIFF....WEBP 是 WebP；例如文件头为 JPEG 时保存为 result.jpg，不要误当 .webp。

调用兼容性

• 优先使用当前 Agent 的 HTTP/multipart 能力，不依赖 Git Bash curl。
• 如必须使用 Git Bash curl -F，文件名含 &、=、空格等特殊字符时，先复制一份到临时简单文件名后再上传，保留原文件不动。
• Git Bash curl 出现 HTTP 000 或 SSL 握手失败时，改用当前环境可用的 HTTP 客户端；不要重复支付或把本地连接错误当作服务端处理失败。
• 已安装旧版时，如调用环境只能重试原始 POST，必须保留原图片、原 edit_instruction 和原 X-Out-Trade-No；服务端会将其作为状态刷新处理。

效果复核

确认指定对象已消失、应保留主体没有被删、背景修复自然。

失败与退款

上游明确失败或任务超过 15 分钟仍未完成时，系统自动标记为 FAILED 并发起原路退款。继续查询同一订单即可看到 refund_status；不要创建新订单或要求用户再次支付。