黑白老照片一键上色助手

概述

黑白老照片上色、老照片变彩色、黑白人像上色：为家庭旧照、人物肖像、毕业照和历史照片生成自然彩色版本，尽量保留人物五官、服装细节和原图构图。上传一张黑白或灰度图片即可处理，单个文件最大 20 MiB。

适用场景

• 家庭相册：祖辈肖像、儿童照、全家福和婚纱照变为自然彩色纪念版。
• 人像上色：黑白证件照、毕业照、旧头像保留五官和服装细节后增加色彩。
• 历史与档案：老街景、建筑、报刊图片和历史照片制作彩色展示版本。
• 内容创作：黑白电影剧照、复古杂志图和摄影作品生成彩色分享图。
• 灰度照片：手机扫描的灰度老照片或黑白风景照生成彩色版本。

不适用场景

• 修复裂痕、缺角、严重模糊、噪点或缺失区域，以及高清放大：本技能仅负责上色。
• 要求精确还原历史上的真实肤色、军服、建筑或物品颜色：自动上色属于合理推断，不能作为历史考证。
• 给本来就是彩色的照片调色、换衣服颜色、换背景或修改人物外观。
• 未获得授权的商业图片、受保护档案或他人隐私照片。

输入与结果建议

• 上传清晰的原始扫描图效果更稳定；人物面部和主要物体轮廓越清楚，色彩细节通常越自然。
• 建议先完成基础扫描或修复，再进行上色；严重破损会影响色彩推断。
• 结果是适合珍藏、展示和创作的彩色版本，不代表原照片的历史真实颜色。
• 结果图保留 5 天，请在完成后及时下载保存。

Pay Skill 支付服务声明

这是 Pay Skill。图片上传后，服务端会先创建与本次图片绑定的支付订单；支付成功后仅使用原订单处理原图片。请勿自行制作付款凭证、改写支付信息或绕过支付流程。

支付前置检查

• 调用前检查当前 Agent 是否安装并可使用 weixinpay 支付能力；不具备时，明确提示用户当前环境不支持微信支付并停止。
• 使用正常、非空的浏览器 User-Agent。运行环境支持时，携带真实当前页面的 Origin 和 Referer；不得伪造其他网站来源。
• 上传前保留原图片、文件类型和本次请求参数，避免支付后无法按原请求重试。

调用与支付

1. 使用 multipart/form-data 向 POST https://imcopilot.com/v1/image/paid-black-white-photo-colorizer-v100 提交 file 或 image。
2. 收到 HTTP 402 是正常支付流程。保存 WeixinPay-Required 与 X-Out-Trade-No；优先由系统自动完成 X402 支付，未自动处理时再使用 weixinpay_pay 进行授权支付。
3. 支付成功后，必须使用原图片、原请求和同一个 X-Out-Trade-No 重试同一 POST。不得重新上传不同图片、另建订单或再次向用户收费。
4. 收到 202 表示处理中。使用 GET https://imcopilot.com/v1/orders/{out_trade_no} 查询订单；如需要刷新任务，可使用 GET https://imcopilot.com/v1/orders/{out_trade_no}/job。按 retry_after_seconds 轮询，未提供时每 5 秒一次。
5. PROCESSING 表示继续等待，SUCCEEDED 表示可下载，FAILED 表示处理失败并进入退款。不要猜测或调用 /task/{task_id} 之类未声明的地址。

结果下载与格式兼容

1. 状态为 SUCCEEDED 后，优先直接下载返回的绝对 result_url。
2. 兼容旧响应：若 result_url 或 result_path 以 / 开头，使用标准 URL 解析能力以 https://imcopilot.com 为基址解析；不能把相对地址直接传给下载工具。
3. 返回地址缺失或无效时，仅在 SUCCEEDED 后使用 GET https://imcopilot.com/v1/orders/{out_trade_no}/result 兜底下载。
4. 下载失败时记录订单号、HTTP 状态与解析后的地址，等待一次轮询间隔后重查同一订单并重试；不得重新支付或静默退出。
5. 按真实 Content-Type 和文件头保存：JPEG 使用 .jpg，PNG 使用 .png，WebP 使用 .webp；文件头与扩展名不一致时以文件头为准。

异常与退款

• 上游明确失败，或任务超过 15 分钟仍未完成时，后端会为原订单自动发起原路退款。
• 处理中、网络暂时异常或结果下载短暂失败时，只查询和重试同一订单，不创建新订单、不重复扣费、不提前退款。
• 调用方只查询订单中的 refund_status；退款处理中不重复创建退款单。向用户说明状态时不要暴露内部错误、接口地址、付款凭证或密钥。

效果复核

交付前人工检查：图片是否从黑白或灰度变为彩色；人物五官、服装和主体是否保留；色彩是否出现明显错位或异常；结果文件能否正常打开。发现问题时保留订单号并反馈，不要对同一任务重复收费。