higgsfield-image-auto

使用 Playwright 自动生成 Higgsfield 图像

此技能通过 Playwright 浏览器自动化，自动完成 Higgsfield 图像生成的整个流程。它会前往图像生成页面、输入提示词、配置设置并点击 Generate，全程无需手动操作。

---

前提条件

• 用户必须已在 Playwright 浏览器会话中登录 higgsfield.ai
• 必须启用 Playwright MCP 插件
• 首次使用前，先用 ToolSearch 加载每个 Playwright 工具

输入要求

用户需提供：

1. 图像的文本提示词（或先调用 /ugc-hot-girl 生成提示词）

可选覆盖项（显示默认值）：

• 模型：Soul 2.0（选项：Soul 2.0、Soul Cinema、Nano Banana Pro、Nano Banana 2、Seedream 5.0 lite、GPT Image 1.5、Grok Imagine、FLUX.2、Reve、Z-Image）
• 宽高比：3:4（选项：1:1、3:4、4:3、9:16、16:9、2:3、3:2）
• 分辨率：2k（选项：1k、2k、4k）
• 图像数量：1（选项：1-4）

---

模型 URL 对照表

每个模型都有自己的 URL 路径：

模型	URL
Soul 2.0	/image/soul-v2
Soul Cinema	/image/soul-cinematic
Nano Banana Pro	/image/nano-banana-pro
Nano Banana 2	/image/nano-banana-2
Seedream 5.0 lite	/image/seedream_v5_lite
GPT Image 1.5	/image/openai_hazel
Grok Imagine	/image/grok_image
FLUX.2	/image/flux_2
Reve	/image/reve
Z-Image	/image/z-image

默认：Soul 2.0（/image/soul-v2）——最适合生成写实肖像和 UGC 角色。

---

自动化流程

步骤 1：前往图像生成页面

browser_navigate → url: "https://higgsfield.ai/image/soul-v2"

如果用户要求使用其他模型，请将 soul-v2 替换为上表中的相应模型路径。

等待页面加载，然后截取快照进行确认：

• 页面标题包含模型名称
• 提示词文本框可见

步骤 2：找到并点击提示词文本框

截取快照。查找：

textbox [ref=eXX]

它位于页面底部的 group [ref=eXX] 中。占位文本为“Describe the scene you imagine”。

该文本框的 Playwright ID 为 [id="hf:tour-image-prompt"]——Playwright 可能会自动使用此选择器。

browser_click → ref: <textbox_ref>, element: "Image prompt textbox"

步骤 3：输入提示词

browser_type → ref: <textbox_ref>, text: "<the image prompt>"

重要：使用 fill 方法（默认），不要使用 slowly: true。该文本框是标准输入框，并非 Lexical 编辑器。

步骤 4：调整设置（可选）

如果用户需要使用非默认设置，请点击相应按钮：

宽高比——找到显示当前宽高比的按钮（例如，“3:4”）：

browser_click → ref: <ratio_button_ref>, element: "Aspect ratio selector"

然后从下拉选项中选择。

分辨率——找到显示当前分辨率的按钮（例如，“2k”）：

browser_click → ref: <resolution_button_ref>, element: "Resolution selector"

图像数量——找到增加/减少按钮（显示“1/4”）：

• 点击“Increment”按钮以增加数量（最多 4 张）
• 点击“Decrement”按钮以减少数量

角色/情绪板——右侧面板显示“CHARACTER”和“General”情绪板。点击“Change”进行切换。

步骤 5：生成

截取屏幕截图，向用户展示表单状态。

点击 Generate 前，请征求用户确认——此操作会消耗点数/免费生成次数。

找到并点击 Generate 按钮：

browser_click → ref: <generate_button_ref>, element: "Generate button"

Generate 按钮会显示剩余免费生成次数（例如，“Generate 4915 free gens left”）。

步骤 6：等待生成

browser_wait_for → time: 15

使用 Soul 2.0 生成图像通常需要 10-20 秒。

步骤 7：验证结果

截取屏幕截图。新生成的图像会显示在页面顶部 History 网格的第一项。

如需查看完整图像，请点击网格中的第一项。这会打开“Asset showcase”对话框，其中包含：

• 全尺寸图像预览
• 提示词详情
• 操作按钮：Overview、Upscale、Enhancer、Relight、Inpaint、Angles
• 底部操作：Animate、Publish、Open in、Reference、Download

步骤 8：向用户报告

告知用户图像已成功生成。如果这是 UGC 工作流的一部分，请提醒他们现在可以使用 /seedance-auto-generate 根据此图像创建视频。

---

关键元素模式

这些模式有助于浏览页面。Refs 会因会话而变化——请始终获取最新快照。

元素	查找方式
提示词文本框	带有 Playwright ID hf:tour-image-prompt 的 textbox
模型选择器	位于包含模型名称（例如 “Soul 2.0”）的 group 中的 button
纵横比	显示比例文本（例如 “3:4”）并带有下拉箭头的 button
分辨率	显示分辨率（例如 “2k”）并带有下拉箭头的 button
图像数量	带有计数器 “X/4” 的 button "Decrement/Increment"
颜色迁移	button "Color Transfer New"
角色面板	右侧带有 “CHARACTER” 标签的 complementary 区域
生成按钮	显示剩余免费生成次数的 button "Generate ..."
历史记录网格	包含多个 img "image generation" 子元素的 generic 容器
第一张生成的图像	历史记录网格容器内的第一个 generic 子元素

---

错误处理

• 未登录：如果页面显示登录提示，请让用户登录（! open https://higgsfield.ai）
• 未找到提示词文本框：输入栏偶尔不会渲染。请刷新页面并重试。
• 模型不可用：部分模型需要订阅。请查看是否有升级提示。
• 生成失败：网格中会显示图像的 “Failed” 状态。建议重试或简化提示词。

---

工作流集成

此技能是 UGC 工作流的第 2 步：

1. /ugc-hot-girl — 生成角色图像提示词
2. /higgsfield-image-auto ← 你当前所在的位置 — 自动在 Higgsfield 上生成图像
3. /seedance-auto-generate — 将生成的图像带到 Seedance 2.0 视频页面

图像如何传入视频

在此处生成图像后，它会自动显示在 Seedance 2.0 视频创建页面中：

1. 前往 /create/video?model=seedance_2_0
2. 点击上传区域 → 打开媒体对话框
3. 点击 “Image Generations” 标签页
4. 最新生成的图像会显示为第一项
5. 点击该图像进行选择（按钮会从 “Check eligibility” 变为带绿色勾号的已选状态）
6. 按 Escape 关闭对话框——图像现在已加载到视频表单中

无需下载或上传文件——Higgsfield 的内部资产系统会将图像生成结果直接连接到视频创建功能。