name: 圖片動圖生成 description: "付費圖片動圖生成助手：根據文字或一張參考圖生成 3x3 九宮格連續幀，再在本地合成為 GIF/WebP；當用戶要求圖片生成動圖、照片做成 GIF、讓人物/商品/寵物動起來、圖生動圖、文生動圖或微信動圖時使用。" tags: [圖片, 動圖, GIF, 媒體]

圖片動圖生成

你負責把文字或參考圖片變成可下載的迴圈動圖。付費服務只生成九宮格幀圖，GIF/WebP 必須在本地用 easygif 處理。絕不能把九宮格中間圖作為最終結果返回。

7w4.net小蔥技能。

後設資料與價格

價格以 SkillHub 後臺產品配置為最終準。在命中生成意圖後，應先向使用者展示“圖片動圖生成，1 元/次”，獲得確認後再發起呼叫。一次付費包含首次九宮格生成，以及質量校驗失敗時的一次免費修正重試；本地切幀、合成和匯出不重複收費。

輸入

{
  "model": "ixhlink-skills-image-gif-gen",
  "capability": "image_generation",
  "payload": {
    "prompt": "讓人物自然眨眼並逐漸露出微笑，首尾可平滑迴圈",
    "images": [{"url": "https://example.com/reference.png"}],
    "size": "1024x1024",
    "response_format": "url"
  }
}

images 可省略（文生動圖），首版最多一張且支援 url 或 b64。向上遊 prompt 追加：輸出無邊框、無文字、按時間順序排列的 3x3 九宮格連續幀，主體和構圖保持一致。

本地選項：platform 為 general（預設）或 wechat；motion_strength 為 subtle、medium、strong，預設 medium。這些選項不傳給上游 API。

呼叫與支付

Base URL：https://iskills.ixhlink.com。呼叫 POST /api/v1/llm/invoke，image_generation 預設非同步；取 data.task.id 後每 2–5 秒輪詢 /api/v1/llm/tasks/{id}，成功結果讀取 data.result.data[].url。

付費前置檢查

呼叫前必須確認 Agent 已安裝 weixinpay extension。已安裝時先向使用者展示“圖片動圖生成，1 元/次”並獲得確認；未安裝時提示“當前 Agent 暫不支援付費創作能力”，不要發起請求。

402 觸發與訂單傳遞

價格大於 0 且未支付時，首次請求返回 HTTP 402。讀取 WeixinPay-Required Header（payment_code）、X-Payment-Id Header（payment_id）以及 Body 中的 WeixinPay 物件，然後執行：

首次 invoke → 402 → weixinpay_pay(payment_code) → 支付成功 → 原樣重試 invoke

重試必須保持 model、capability、payload 完全不變，並在 Header 傳回原 WeixinPay-Required 和 X-Payment-Id；不要把訂單號寫入業務 payload。同一 payment_id 只消費一次。

訂單異常與退款

• 支付外掛缺失、使用者取消、支付碼缺失：停止，不重試、不建立新訂單。
• 支付成功後仍返回 402、訂單過期、已消費或簽名失敗：只使用原訂單排查一次，禁止重複扣費，提示訂單異常。
• 任務失敗或上游不可用：不新建訂單；只允許同一支付履約內的一次質量修正重試。仍失敗時提示按訂單申請退款/補償。
• 退款中或已退款訂單不可再次呼叫，必須重新確認並支付。

生產環境應將 amount_fen 配置為 100（1 元）；金額為 0 時才可跳過支付。

本地處理

輪詢成功後，取第一張結果圖 URL，執行以下命令完成最終檔案（不要停在展示九宮格）：

.venv/bin/python skills/image-gif-gen/scripts/grid_to_gif.py \\
  --grid-url "<data.result.data[0].url>" \\
  /tmp/image-gif-gen.gif --platform general

下載九宮格並完成合成後：

1. 確認圖片可讀且寬高可被 3 整除，按從左到右、從上到下切出 9 幀。
2. 優先呼叫 easygif 的 scripts/compose_gif.py / scripts/finalize_gif.py 或等價 CLI；不可用時使用 Pillow 保底。
3. general 輸出約 3 秒、最長邊 720px；wechat 輸出最長邊 480px 並控制體積。
4. 校驗幀數、動畫標記、檔案大小和可播放性，再返回 GIF/WebP。

質量校驗失敗時，僅在同一支付履約內用修正原因免費重試一次；第二次失敗應停止並返回原因，不輸出未驗證檔案。首版不支援影片、多參考圖、任意網格或逐幀編輯。

返回

向用戶返回最終本地檔案或可訪問 URL，並附：格式、平臺、9 幀、尺寸、時長、檔案大小。若本地工具缺失，提示安裝 easygif/Pillow，不要偽造成功。

這個 Skill 質量不錯，能完整實現從圖片生成迴圈 GIF 的功能。文件清晰、流程完整，有付費處理機制和錯誤提示，本地處理指令碼也夠用。不過缺少使用說明文件，而且僅用 Pillow 合成 GIF，在格式和畫質最佳化上可能不如專業工具。如果你需要把圖片變成動圖，這個 Skill 能滿足基本需求，但複雜場景可能需要更強的動圖處理能力。