Agent Skills
返回列表
Image2 图片任务创建与查询

Image2 图片任务创建与查询

设计多媒体 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_4bd21536/image2-kancyai

技能介绍

解决的问题

image2-kancyai 处理的是异步图片生成接口中常见的工程细节：创建任务后只返回任务 ID，调用方需要继续轮询；参数不一致时容易重复提交，导致积分被不必要消耗；密钥散落在一处也不便复用。它把文生图与图生图任务从参数补齐、认证读取、创建到最终结果提取串成一条稳定流程。

工作方式

技能先校验 prompt、modelType 和 size，并在 img2img 模式下确认 urls 为 1 到 8 个可用地址。认证信息优先读取本次显式传入的 x-api-key，其次读取会话级 X_API_KEY；只有用户明确允许时才读取本地配置。创建调用前会输出请求摘要和积分提醒，成功后记录任务 ID，随后按固定接口持续查询，直到状态为 success、failed 或超时。最终优先返回 imgUrls，失败时输出 failReason。

适用边界

该技能只面向 text2img 与 img2img 图片生成，不覆盖视频、音频、OCR 或非生成式编辑。默认单轮只创建一次任务，禁止未经确认自动重试；遇到限流、密钥失效或服务异常时，应交由用户判断后续操作。

使用场景

  • 接到电商海报需求后，用一段产品描述创建 3:4 的 Image2 文生图任务，并拿到最终图片地址。
  • 收到一组参考图时，校验 URL 数量后创建 img2img 任务，持续轮询到成功或失败原因。
  • 做社媒封面时，选择 16:9 或 9:16 比例，确认积分提示后再创建任务，避免重复提交。
  • 需要复用密钥时，使用 X_API_KEY 或显式 key 完成 Image2 请求，并在日志中只保留掩码信息。

适合人员

  • 负责电商主图和海报生成的设计助理，需要把参考图快速转成可用图片地址。
  • 维护营销素材自动化流程的工程师，需要稳定创建 Image2 异步任务并轮询最终状态。
  • 接入可想 AI 图像能力的产品工程师，需要按固定字段创建 text2img/img2img 任务。
  • 处理封面图需求的运营同学，需要指定 16:9 或 3:4 比例并拿到失败原因。