智能照片换装

要解决的问题

给定一张人物照片，想换掉身上的服装，常见做法是手写长提示词交给通用图像编辑模型。问题在于：提示词一长，风格就漂移；改了服装，五官和背景跟着一起变；不同任务之间难以复用同一套风格设定。这个技能把换装封装成一个固定配方的异步图像编辑接口，客户端只需要做最小输入。

核心能力与调用流程

技能基于 HTTP API，Base URL 为 https://iskills.ixhlink.com，model 固定为 ixhlink-skills-photo-outfit-swap，capability 固定为 image_edit。用户必须提供至少一张人物照片，可选追加一张服装参考图。风格配方由服务端技能画布固定应用，客户端不要自行拼接长 prompt 或风格模板。

调用前先观察人物照，把关键字段写入 payload.options：

• gender：以第一张人物照为准，填 female 或 male
• age：目测年龄或「青年」
• person：可选，完整人物短语，有则优先生效
• clothing：目标服装描述；单图模式必填，双图模式可省略
• note：可选，用户补充的短句要求

用户文字与图片冲突时，以图片为准（除非用户明确要求按文字改性别或年龄）。

提交换装任务有两条路径：直接 POST /api/v1/llm/invoke，或用 POST /api/v1/llm/tasks 创建异步任务。image_edit 是慢任务，默认异步，提交后轮询 GET /api/v1/llm/tasks/{task_id} 直到 status = succeeded，再从 data.result.data[].url 取结果图片 URL 返回给用户。

付费与边界

这是付费技能，单价 1 元/次。调用前必须检查当前 Agent 是否已安装微信支付能力（weixinpay extension）；未安装时提示用户并终止流程。首次请求若返回 HTTP 402，响应中会携带 WeixinPay-Required 和 X-Payment-Id 两个 Header，支付完成后用相同的 JSON body 重试即可，订单参数走 Header。amount_fen = 0 时可跳过支付，每笔订单按次消费、不可复用。

几个容易踩的坑：

• 单图模式（无服装参考图）必须在 options.clothing 写目标服装描述，否则会返回 400
• 不要在客户端重写风格长文，服务端画布会覆盖 prompt 字段
• 任务失败时查看 data.error_message（已脱敏），调整 options 后重新提交，而不是换一套 prompt 重来
• 出图后做质量自检：五官表情姿势一致、服装贴合身形、背景光线保持、无变形或多余手指