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 字段：

提交成功响应（异步）：

{
  "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
小葱技能站7w4.net每天更新，海量AI技能等你发现。

任务状态： 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 图片编辑需求的用户，值得一试。