照片换风格助手

概述

将照片转换为用户指定的视觉风格，尽量保留主要主体和原始构图。

适用场景

• 照片转水彩、油画、复古胶片、插画、动漫等风格。
• 商品或场景图制作统一的视觉风格稿。

热门风格可选

• 日系动漫、吉卜力感手绘：适合生活照、旅行照和头像的手绘动画效果。
• 国风水墨、工笔插画：适合古风写真、风景和文化主题内容。
• 3D 卡通、潮玩手办：适合头像、亲子照和社交媒体趣味内容。
• 赛博朋克、未来科技：适合夜景、城市、游戏感和科技主题图片。
• 复古胶片、水彩、油画：适合日常照片的艺术化质感转换。

用户也可以直接描述想要的其他视觉风格；开始处理前确认目标风格和需保留的主体、物品或构图。

不适用场景

• 要求人物身份、文字内容或商品细节完全不变。
• 仅改背景颜色、仅改文字或替换局部物品：使用对应专项 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-style-changer 提交 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-style-changer 轮询：携带原 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 https://imcopilot.com/v1/orders/{out_trade_no}/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；不要创建新订单或要求用户再次支付。