SeeAny 爆款复刻

当用户希望参考竞品爆款图片的构图、灯光、背景或视角氛围，来生成自家商品的同款风格图片时，使用这个 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。

第三步：必须使用用户提供的图片

这个 skill 只能使用用户明确提供的图片。

严格规则：

1. inputImgs（商品图）：必须为用户当前上传或明确提供的自家商品图片。
2. refImgs（爆款参考图）：必须为用户当前上传或明确提供的爆款/竞品参考图。
3. 不允许擅自去 Unsplash、Pinterest、Google、商品站点或任何其他外部网站搜索替代图片。
4. 第一优先级：用户当前会话上传的图片；第二优先级：用户当前会话明确给出的图片 URL。

这个 Skill 做什么

• 提交 POST /api/ai/batchsmarttask
• 使用 aiTypeId=6491 和 aiType=hotReplica
• 结合自家商品图 (inputImgs) 与爆款参考图 (refImgs)
• 自动生成保持自家商品外观形态、但复刻参考图画面风格与构图的商业商品图
• 当用户要看进度或最终结果时，查询 GET /api/developer/task/status

调用约定

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

输入说明

• inputImgs (必须): 自家商品图 URL 列表，上限 6 张
• refImgs (必须): 爆款参考图 URL 列表，上限 20 张
• prompt (可选): 补充描述词或微调说明（如“保持纯净背景，突出亮面金属光泽”）
• mode (可选): 模型标识，默认 nano-banana-pro
• size (可选): 分辨率，默认 1K（可选 1K / 2K / 4K）
• imgNum (可选): 每张输入图的生成张数，默认 1
• imgRatio (可选): 成图比例；未传时默认 -2（智能比例），也可传 1:1、4:5、3:4 等
• isBatchMode (固定): 脚本会自动传 1，与站内爆款复刻页保持一致

轮询与响应

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

参考文件

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