SeeAny 智能创作

当用户希望通过输入详细的文本描述词（Prompt），或结合已有的商品/场景参考图来直接生成电商商品图、广告背景图或创意图片时，使用这个 skill。

第一步：先解决 API Key

必须按下面的顺序处理 API Key：

1. 如果已经设置了 SEEANY_API_KEY，直接使用。
2. 如果用户在当前对话里粘贴了 SeeAny API Key，就仅在本次会话里使用它。
3. 如果两者都没有，就停止调用，并明确告诉用户：
   - 打开 https://www.seeany.com/developer/keys
   - 创建或查看 API Key
   - 把 API Key 粘贴到聊天里，让 WorkBuddy / OpenClaw 继续执行

不要索取 callback secret 或其他凭证。这里只需要 API Key。
除非用户明确要求，不要把用户粘贴的 API Key 写入仓库文件。

第二步：必须带 User-Agent

调用 SeeAny API 时必须显式带 User-Agent 请求头，否则可能被网站防火墙拦截。

建议值：

• seeany-api
• workbuddy
• openclaw
• arkclaw
• xclaw
• 或其他能标识调用方的名称

如果调用方没有自己的标识，默认使用 seeany-api。

第三步：必须使用用户提供的图片或明确描述

严格规则：

1. 如果提供了 inputImgs（参考图/商品图），必须为用户当前上传或明确提供的图片 URL。
2. 不允许擅自去 Unsplash、Pinterest、Google、商品站点或任何其他外部网站搜索替代图片。
3. 如果没有上传图片，可以仅依靠用户给出的 prompt 文本描述词进行纯文案生图。

这个 Skill 做什么

• 提交 POST /api/ai/smarttask
• 使用 aiTypeId=113 和 aiType=smartImg
• 根据用户给出的 prompt 及可选的 inputImgs 生成图片
• 当用户要看进度或最终结果时，查询 GET /api/developer/task/status

调用约定

• 提交任务时运行 scripts/seeany_smart_creation.py submit
• 查询状态时运行 scripts/seeany_smart_creation.py poll
• submit 从 stdin 或 --payload-file 读取 JSON
• 调用时必须显式带 User-Agent
• API Key 优先顺序：
  1. --api-key
  2. SEEANY_API_KEY
  3. 用户在当前对话粘贴的 API Key

输入说明

• prompt (必须): 画面描述词，详细描述主体、场景、光影、构图与风格
• inputImgs (可选): 输入/参考图片 URL 列表，上限 10 张
• mode (可选): 模型标识，默认 nano-banana-pro
• size (可选): 分辨率，默认 1K（可选 1K / 2K / 4K）
• imgNum (可选): 输出图片张数，默认 1
• imgRatio (可选): 输出比例；未传时默认 -2（智能比例），也可传 1:1、3:4、4:3、16:9、4:5

轮询与响应

提交成功后，会返回 task_uuid。当用户询问进度或查看出图资产时，使用 poll 指令传入 task_uuid 获取最新的处理状态与生成图片结果。

参考文件

• references/payloads.md：输入 JSON 和响应结构