全能图片生成

要解决什么问题

在 Agent 里做「画图」时，常见痛点是：上游模型各异、同步接口容易超时，以及按次计费时的支付与重试规则不统一。本技能把 ixhlink 的 image_generation 能力封装成固定调用约定：慢任务默认走异步，输出以图片 URL 为主，并在需要付费时通过 HTTP 402 与微信订单头完成「原样重试」。

核心能力与调用流程

服务基址为 https://iskills.ixhlink.com，路径与 Base URL 拼接使用。典型流程如下：

1. （可选）GET /api/v1/llm/models 确认目标模型已启用。
2. POST /api/v1/llm/invoke 提交生成；请求体含 model、capability: image_generation 与 payload。
3. payload 必填 prompt（也可用 description / text，服务端会归一化）；可选 size、n、quality、response_format（建议 url），以及 images 数组做图生图（项内 b64 或 url）。
4. 异步成功时从响应取 data.task.id，轮询 GET /api/v1/llm/tasks/{task_id}，直至 status 为 succeeded 或 failed；成功结果在 data.result.data[].url。
5. 也可直接用 POST /api/v1/llm/tasks 创建异步任务（请求体相同）。

付费侧：调用前须确认 Agent 已安装 weixinpay extension；未安装应提示用户并终止。命中创作意图后应向用户展示服务名与单价（资料中为 0.8 元/次，以 SkillHub 后台为准）。首次调用若 amount_fen > 0 且未支付，会返回 402，Header 含 WeixinPay-Required、X-Payment-Id；支付成功后用完全相同的 JSON body 重试，勿用改 payload 的方式传订单号。

适用边界与注意点

• 轮询：建议间隔 2–5 秒，业务超时可设 3–5 分钟；failed 时查看 data.error_message（已脱敏）。
• 错误码：400 多为缺 model 或非法 payload；404 为模型未启用或 capability 不匹配；503 为模型站点未启用。
• 免费路径：amount_fen = 0 时可跳过支付；每笔订单按次消费，不可复用。