图片动图生成

要解决的问题

让静态图片"动起来"，常见做法是分别调文生图接口再自己拼帧，但多数图像生成服务只返回单张静态图，帧间一致性全靠 prompt 硬凑，结果常常出现主体漂移、跳帧和闪烁。另一个坑是格式转换：上游即使给出多帧，接入方还得自己处理切帧、合成与体积优化。这个技能把"生成连续帧"和"本地合成动图"拆成两段，各自用合适的工具完成。

工作流程

• 上游生成九宫格：把用户的文字描述或一张参考图（URL 或 base64）发给图像生成接口，提示词会追加"无边框、无文字、按时间顺序排列的 3×3 九宫格连续帧，主体和构图保持一致"的约束，产出的是一张九宫格帧图，而不是动图本身。
• 付费与轮询：调用前确认支付插件就绪，并向用户展示价格（1 元/次）获得确认。接口默认异步，拿到 data.task.id 后每 2–5 秒轮询一次，成功结果从 data.result.data[].url 读取。遇到 HTTP 402 时，按 WeixinPay-Required、X-Payment-Id 两个 Header 和 Body 中的 WeixinPay 对象完成支付重试；重试必须保持 model、capability、payload 完全不变，订单号不写入业务参数。
• 本地合成：下载九宫格后先校验宽高可被 3 整除，按从左到右、从上到下切出 9 帧，优先用 easygif 的 compose_gif.py / finalize_gif.py 合成，工具缺失时回退到 Pillow。general 平台输出约 3 秒、最长边 720px；wechat 输出最长边 480px 并控制体积。
• 校验后交付：检查帧数、动画标记、文件大小和可播放性，返回最终的 GIF/WebP 文件，并附上格式、平台、帧数、尺寸、时长和文件大小。

适用边界与注意点

• 付费只覆盖首次九宫格生成和一次质量修正重试；切帧、合成、导出都在本地完成，不重复收费。
• 绝不能把九宫格中间那张图当作最终结果返回——那是预览，不是动图。
• 首版不支持视频输入、多参考图、任意网格或逐帧编辑；platform 和 motion_strength 是本地选项，不会传给上游 API。
• 支付异常（插件缺失、用户取消、订单过期、重复消费）时不新建订单；重试只在同一支付履约内进行一次，仍失败则提示按订单申请退款。