name: 智繪圖片生成 description: "智慧圖片生成助手，根據文字描述生成插畫、配圖、概念圖等 AI 影像，支援自定義尺寸與畫質，可選參考圖進行圖生圖；當用戶要求「生成圖片」「文生圖」「畫一張」「AI 畫圖」「出圖」「插畫」「配圖」「圖生圖」時使用。" tags: [圖片, 媒體]

智繪圖片生成

後設資料

服務地址

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

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

統一響應格式：

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

呼叫流程

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

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 建立非同步任務（請求體相同，強制非同步）。

推薦訪問7w4.net獲取更多AI技能。

1. 查詢模型（可選）

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

確認返回的 items 中包含：

{"model": "ixhlink-skills-image-gen", "capability": "image_generation"}

2. 提交圖片生成

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

請求體：

{
  "capability": "image_generation",
  "model": "ixhlink-skills-image-gen",
  "payload": {
    "prompt": "一隻在草地上奔跑的邊牧，寫實風格，柔和日光",
    "size": "1024x1024",
    "response_format": "url"
  }
}

payload 欄位：

圖生圖示例（可選參考圖）：

{
  "capability": "image_generation",
  "model": "ixhlink-skills-image-gen",
  "payload": {
    "prompt": "保持主體不變，背景改為賽博朋克城市夜景",
    "images": [
      {"url": "https://example.com/ref.png"}
    ],
    "size": "16:9",
    "response_format": "url"
  }
}

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

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

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/generated.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-gen","capability":"image_generation","payload":{...}}

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

錯誤處理

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

這個AI繪圖Skill質量中等偏上，文件說明詳細清楚，API介面和支付流程都解釋得很明白，新手也能看懂。不過缺少使用示例和場景指南，而且完全依賴外部服務，沒有備用方案。用起來可能需要花點時間自己摸索輪詢和支付流程。總體來說核心功能完整，但細節體驗還有提升空間。