技能介绍

它解决什么问题

让静态人像变成带颗粒感的像素画并不简单。如果由客户端自行拼提示词，很容易在两个地方翻车：一是像素颗粒与人物特征的取舍不稳定，二是各家上游模型对 “复古游戏风” 的理解不一致，导致批次出图风格漂移。这个 Skill 把风格配方固化在服务端画布，客户端只需要把参考图和结构化选项交上去，拿到可展示的结果 URL。

技能如何工作

角色是像素风格照片的调用助手，统一走 iskills.ixhlink.com 的 HTTP API，不要臆造上游模型或第三方接口。
请求体固定使用 model: ixhlink-skills-pixel-style-photo，capability: image_edit，客户端不要提交完整风格 prompt；风格由服务端画布节点组装。
流程：确认参考人像 → 观察图片并填写 payload.options → POST /api/v1/llm/invoke → 出现 402 时走微信支付并用相同 JSON body 重试 → 轮询 GET /api/v1/llm/tasks/{task_id} → 从 data.result.data[].url 取图。
payload.options 支持 gender、age、person、pixel_level、scene、note。像素精度分 fine、medium、retro；scene 默认 keep，也可以填简短场景句；文字与图片冲突时以图片为准。
异步任务状态为 pending → running → succeeded / failed，建议间隔 2–5 秒轮询，并设置 3–5 分钟的超时上限。

适用边界与注意点

用户必须提供至少 1 张参考人像；缺图时只能提示上传，不能凭空生成。
付费前置检查很重要：调用前确认当前 Agent 是否已安装 weixinpay extension。未安装时应直接提示不支持付费创作，并终止流程。
402 代表需要支付或预下单失败。支付成功后必须用完全相同的 JSON body 重试，订单参数只放在 Header WeixinPay-Required 与 X-Payment-Id 里。amount_fen = 0 时可跳过支付，每笔订单按次消费且不可复用。
提交失败时优先看 400（缺图、画布未配置、options 不足）、404（模型未启用或 capability 不匹配）、503（服务暂不可用）。任务失败后查看 data.error_message，必要时调整 pixel_level 或 note 重试。
出图后做结果自检：人物发型、发色、服装颜色与参考图一致；像素颗粒清晰整齐、边缘锐利；无抗锯齿模糊、马赛克脏乱或噪点。仍不要在客户端重写风格长文，避免破坏服务端画布的一致性。