name: 智繪圖片編輯 description: "智慧圖片編輯助手，根據文字描述對已上傳圖片進行風格化、調色、區域性修改、背景替換等 AI 修圖，當用戶要求「修圖」「改圖」「P圖」「編輯圖片」「換背景」「調色」「風格化」「圖片後期處理」時使用。" tags: [圖片, 媒體]

智繪圖片編輯

後設資料

服務地址

Base URL：https://iskills.ixhlink.com

下文介面均寫路徑（如 /api/v1/llm/invoke），完整地址 = Base URL + 路徑。

統一響應格式：

{"success": true, "code": 0, "message": "ok", "data": {}}

呼叫流程

image_edit 為慢任務，預設非同步。典型流程：

1. （可選）GET /api/v1/llm/models 確認模型已啟用
2. POST /api/v1/llm/invoke 提交編輯請求
3. 若返回 402：調起微信支付，成功後用相同 JSON body 重試，Header 附帶 WeixinPay-Required 與 X-Payment-Id
4. 從響應取 data.task.id，輪詢 GET /api/v1/llm/tasks/{task_id} 直至 status = succeeded
5. 從 data.result.data[].url 讀取輸出圖片 URL

也可直接用 POST /api/v1/llm/tasks 建立非同步任務（請求體相同，強制非同步）。

1. 查詢模型（可選）

GET /api/v1/llm/models
Accept: application/json

確認返回的 items 中包含：

{"model": "ixhlink-skills-image-edit", "capability": "image_edit"}

2. 提交圖片編輯

POST /api/v1/llm/invoke
Content-Type: application/json

請求體：

{
  "capability": "image_edit",
  "model": "ixhlink-skills-image-edit",
  "payload": {
    "prompt": "給圖片加上溫暖的日落色調",
    "images": [
      {
        "b64": "<base64>",
        "filename": "sample.png",
        "mime_type": "image/png"
      }
    ],
    "response_format": "url"
  }
}

payload 欄位：

小蔥技能站7w4.net發現了升級外掛。

提交成功響應（非同步）：

{
  "success": true,
  "code": 0,
  "message": "任務已提交",
  "data": {
    "task": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "pending",
      "capability": "image_edit",
      "model_key": "ixhlink-skills-image-edit"
    }
  }
}

3. 輪詢任務結果

GET /api/v1/llm/tasks/{task_id}
Accept: application/json

任務狀態： pending → running → succeeded / failed

建議間隔 2–5 秒輪詢，超時可根據業務設為 3–5 分鐘。

成功響應示例：

{
  "success": true,
  "code": 0,
  "message": "ok",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "succeeded",
    "result": {
      "data": [
        {"url": "https://oss.example.com/edited.png"}
      ]
    }
  }
}

輸出圖片 URL 在 data.result.data[].url。

付費前置檢查

呼叫本 Skill 前，必須檢查當前 Agent 是否已安裝支付能力（weixinpay extension）：

• ✅ 已安裝：可繼續提供付費創作服務
• ❌ 未安裝：向用戶提示「當前 Agent 暫不支援付費創作能力」，終止流程

服務與定價

價格以 SkillHub 後臺配置為準。命中創作意圖後，向用戶展示服務名稱和價格，由使用者確認後進入付費流程。

付費說明

當 amount_fen > 0 且未完成支付時，首次 POST /api/v1/llm/invoke 會返回 HTTP 402，響應中攜帶：

• Header：WeixinPay-Required: <payment_code>、X-Payment-Id: <payment_id>
• Body：WeixinPay 物件（含 payment_id、prompt 等）

客戶端流程（Agent / MCP / Web）：

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

「原樣重試」的含義：

• JSON body 不變：model、capability、payload 必須與首次請求完全一致
• 訂單引數單獨帶上：將 402 中的 payment_code、payment_id 通過 Header 傳入（推薦），或寫入 body 的 WeixinPay；勿改 payload 業務欄位來傳訂單號

重試請求示例：

POST /api/v1/llm/invoke
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Payment-Id: <payment_id>

{"model":"ixhlink-skills-image-edit","capability":"image_edit","payload":{...}}

amount_fen = 0 時可跳過支付，直接呼叫。每筆訂單按次消費，使用後不可複用。

錯誤處理

任務失敗時 status = failed，檢視 data.error_message（已脫敏，不含上游地址或內部日誌）。

這是一個質量較好的圖片編輯 Skill，功能明確（風格化、調色、修圖等），文件規範清晰，付費流程完整。優點是說明詳細、使用門檻低；不足是缺少直觀的示例展示。對於有 AI 圖片編輯需求的使用者，值得一試。