Agent Skills
返回列表
智绘图片生成

智绘图片生成

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @ixhlink/ixhlink-skills-image-gen。

技能介绍

解决什么问题

当 Agent 需要生成图片时，直接把请求打给上游模型往往会碰到几个现实问题：image_generation 通常是慢任务，不能同步拿结果；prompt、size、n、quality 等字段容易和上游能力不一致；参考图图生图还需要额外传入 b64 或 url；部分调用又涉及 402 付费拦截。ixhlink-skills-image-gen 把这些接口行为收敛到同一个技能入口，让调用方只关心业务参数、任务状态和图片结果。

如何工作

核心链路是异步任务。可以先通过 GET /api/v1/llm/models 确认模型已启用，再调用 POST /api/v1/llm/invoke。请求体携带 prompt，按需携带 size、n、quality、response_format 和参考图 images；成功后读取 data.task.id，再按 2～5 秒间隔轮询 GET /api/v1/llm/tasks/{task_id}，直到 status = succeeded。图片地址位于 data.result.data[].url。如果首次调用返回 402，需要携带 WeixinPay-Required 与 X-Payment-Id，并保持 JSON body 不变 进行重试。也可以直接创建异步任务，但请求体保持一致。

适用边界

它适合文生图、参考图图生图和按次计费场景。注意 payload 中的业务字段在支付重试时不要改写；订单参数应通过 Header 或支付对象传递。未启用模型可能返回 404，上游站点未启用可能返回 503，任务失败时应查看 data.error_message。超时可按业务设置为 3～5 分钟。

使用场景

  • 在智能体应用中，根据用户输入生成 1024x1024 插画并返回可访问图片 URL。
  • 创建品牌视觉素材时，用参考图保持风格一致，提交图生图任务并轮询结果。
  • 接入外部 Agent 前，验证模型启用状态、402 付费流程和 failed 错误信息。
  • 按次计费上线创作功能时，展示 0.3 元/次，触发微信支付后原样重试。

适合人员

  • 接入 Agent 工作流的工程师，需要把文生图变成可轮询的任务并取回图片 URL。
  • 负责智能体付费能力的工程师，需要处理 402、微信支付和原样重试逻辑。
  • 做品牌素材自动化设计的视觉工程师，需要上传参考图并保持生成风格一致。
  • 搭建 Agent 后台的架构师，需要确认模型启用、错误码和任务超时策略。