# Higgsfield Image Auto

> Automatically generate an AI image on Higgsfield using Playwright browser automation. Use when the user has an image prompt and wants to generate it on Higgsfield Soul 2.0 or Nano Banana Pro. Triggers on requests like "generate image on higgsfield", "create image", "auto-generate image", "make the image on higgsfield", or any request to submit an image generation job. Requires Playwright MCP tools.

- Skill: `akcodez/higgsfield-image-auto` (Agent Skill)
- Install (CLI): `npx skillmds@latest add akcodez/higgsfield-image-auto`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akcodez/higgsfield-image-auto/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: akcodez (https://skillmd.com/u/akcodez)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akcodez/higgsfield-image-auto

---


# Higgsfield Image Auto-Generate via Playwright

This skill automates the full Higgsfield image generation flow using Playwright browser automation. It navigates to the image generation page, enters a prompt, configures settings, and clicks Generate — hands-free.

---

## Prerequisites

- User must be **logged in** to higgsfield.ai in the Playwright browser session
- **Playwright MCP** plugin must be enabled
- Load each Playwright tool with `ToolSearch` before first use

## Input Requirements

The user provides:
1. **A text prompt** for the image (or invoke `/ugc-hot-girl` first to generate one)

Optional overrides (defaults shown):
- **Model**: `Soul 2.0` (options: 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)
- **Aspect Ratio**: `3:4` (options: 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2)
- **Resolution**: `2k` (options: 1k, 2k, 4k)
- **Image Count**: `1` (options: 1-4)

---

## Model URL Map

Each model has its own URL path:

| Model | 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` |

**Default**: Soul 2.0 (`/image/soul-v2`) — best for photorealistic portraits and UGC characters.

---

## Automation Flow

### Step 1: Navigate to the image generation page

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

Replace `soul-v2` with the appropriate model path from the table above if the user requests a different model.

Wait for the page to load, then take a snapshot to confirm:
- The page title contains the model name
- The prompt textbox is visible

### Step 2: Find and click the prompt textbox

Take a snapshot. Look for:
```
textbox [ref=eXX]
```
It's inside `group [ref=eXX]` at the bottom of the page. The placeholder text is "Describe the scene you imagine".

The textbox has a Playwright ID: `[id="hf:tour-image-prompt"]` — Playwright may use this selector automatically.

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

### Step 3: Type the prompt

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

**Important**: Use the `fill` method (default), NOT `slowly: true`. The textbox is a standard input, not a Lexical editor.

### Step 4: Adjust settings (optional)

If the user wants non-default settings, click the corresponding buttons:

**Aspect Ratio** — Find the button showing current ratio (e.g., "3:4"):
```
browser_click → ref: <ratio_button_ref>, element: "Aspect ratio selector"
```
Then select from the dropdown options.

**Resolution** — Find the button showing current resolution (e.g., "2k"):
```
browser_click → ref: <resolution_button_ref>, element: "Resolution selector"
```

**Image Count** — Find the increment/decrement buttons (shows "1/4"):
- Click the "Increment" button to increase count (max 4)
- Click the "Decrement" button to decrease

**Character/Moodboard** — The right side panel shows "CHARACTER" with a "General" moodboard. Click "Change" to switch.

### Step 5: Generate

Take a screenshot to show the user the form state.

**ASK THE USER FOR CONFIRMATION** before clicking Generate — this uses credits/free generations.

Find and click the Generate button:
```
browser_click → ref: <generate_button_ref>, element: "Generate button"
```

The Generate button shows remaining free generations (e.g., "Generate 4915 free gens left").

### Step 6: Wait for generation

```
browser_wait_for → time: 15
```

Image generation typically takes 10-20 seconds on Soul 2.0.

### Step 7: Verify the result

Take a screenshot. The newly generated image appears as the **first item** in the History grid at the top of the page.

To view the full image, click on the first grid item. This opens an "Asset showcase" dialog with:
- Full-size image preview
- Prompt details
- Action buttons: Overview, Upscale, Enhancer, Relight, Inpaint, Angles
- Bottom actions: Animate, Publish, Open in, Reference, Download

### Step 8: Report to user

Tell the user the image was generated successfully. If this is part of the UGC pipeline, remind them they can now use `/seedance-auto-generate` to create a video from this image.

---

## Key Element Patterns

These patterns help navigate the page. Refs change between sessions — always take a fresh snapshot.

| Element | How to find it |
|---|---|
| Prompt textbox | `textbox` with Playwright ID `hf:tour-image-prompt` |
| Model selector | `button` inside `group` containing model name (e.g., "Soul 2.0") |
| Aspect ratio | `button` showing ratio text (e.g., "3:4") with dropdown arrow |
| Resolution | `button` showing resolution (e.g., "2k") with dropdown arrow |
| Image count | `button "Decrement/Increment"` with counter showing "X/4" |
| Color Transfer | `button "Color Transfer New"` |
| Character panel | `complementary` section on the right with "CHARACTER" label |
| Generate button | `button "Generate ..."` with free gen count |
| History grid | `generic` container with multiple `img "image generation"` children |
| First generated image | First `generic` child inside the History grid container |

---

## Error Handling

- **Not logged in**: If the page shows a login prompt, ask user to log in (`! open https://higgsfield.ai`)
- **Prompt textbox not found**: The input bar occasionally doesn't render. Refresh the page and retry.
- **Model not available**: Some models require a subscription. Check for upgrade prompts.
- **Generation failed**: The image will show "Failed" status in the grid. Suggest retrying or simplifying the prompt.

---

## Pipeline Integration

This skill is step 2 of the UGC pipeline:

1. **`/ugc-hot-girl`** — Generates the character image prompt
2. **`/higgsfield-image-auto`** ← You are here — automates image generation on Higgsfield
3. **`/seedance-auto-generate`** — Takes the generated image to Seedance 2.0 video page

### How the image flows to video

After generating an image here, it's automatically available in the Seedance 2.0 video creation page:

1. Navigate to `/create/video?model=seedance_2_0`
2. Click the upload area → opens media dialog
3. Click **"Image Generations"** tab
4. The most recently generated image appears as the **first item**
5. Click it to select (it changes from "Check eligibility" button to a selected state with green checkmark)
6. Press Escape to close dialog — the image is now loaded into the video form

**No file download/upload needed** — Higgsfield's internal asset system connects image generations directly to video creation.