[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [HiDream O1 Image](https://spiral.ai/integrations/n8n/hidream-o1-image)

# How to Use HiDream O1 Image in n8n

Use HiDream O1 Image for posters with lettering, illustrated scenes, and storyboard images up to 2048 × 2048 pixels. Unlike HiDream O1 Image Edit, it can start from text alone as well as work from reference images.

|  |  |
| --- | --- |
| Model | HiDream O1 Image |
| Available through | fal |
| Category | Image |
| Price | $0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with HiDream O1 Image in n8n

- Every Monday, use HiDream O1 Image to create a 1024 × 1536 poster draft from that week's approved event brief. Place the exact title at the top, the date below it, and the venue at the bottom.
- For each approved weekly lesson, use HiDream O1 Image to create one 2048 × 2048 storyboard image with three panels. Describe a concrete action in each panel and vary the framing between wide, medium, and close-up.
- Every Monday at 9am: generate a product photo with HiDream O1 Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first.
- Make four logo concepts for a coffee brand called "Northline" with HiDream O1 Image.
- Create a 16:9 hero image of a quiet mountain cabin at dusk with HiDream O1 Image.

## How to set up HiDream O1 Image in n8n

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send n8n this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run HiDream O1 Image in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds HiDream O1 Image, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run HiDream O1 Image**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/hidream-o1-image",
    "input": {
      "prompt": "A cinematic product photo of a ceramic mug on a marble counter, soft window light, shallow depth of field."
    }
  }'
```

Then paste one of the prompts above: n8n finds HiDream O1 Image on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/n8n

## HiDream O1 Image tools and prices

- [Hidream O1 Image](https://spiral.ai/tools/fal/fal-ai/hidream-o1-image) (fal): $0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| reference_image_urls |  | [] | Optional reference images. Use none for text-to-image, one for image editing, or multiple for subject-driven personalization. |
| image_size |  | {"width":1024,"height":1024} | Requested output image size. Dimensions are rounded down to a multiple of 32, up to about 2048x2048 pixels. |
| num_inference_steps | 1 to 50 | 50 | Number of denoising steps. |
| guidance_scale | 0 to 20 | 5 | Classifier-free guidance scale. The full model uses 5.0 by default. |
| seed |  | — | Random seed for reproducible generation. |
| num_images | 1 to 4 | 1 | Number of images to generate. |

## What can you do with HiDream O1 Image in n8n?

Produce recurring visual drafts from approved briefs and reference pictures. An always-on agent can repeat a specified HiDream O1 Image composition for weekly posters, product scenes, or character illustrations.

### Event poster concepts

Create a poster from a written brief with the event name, date, and venue placed in specified regions. Supply the exact wording for each region.

### Storyboard drafts from a script

Turn a short scene description into a multi-panel storyboard image. Specify the action, shot size, and camera angle for each panel.

### Seasonal product scenes

Start with a product reference and request a new setting, such as a picnic table or winter storefront. Name the product details that should stay consistent.

### Product color studies

Use an existing product picture to explore a different surface color. State which object changes and which materials, markings, and surrounding objects should remain.

### Localized sign concepts

Revise lettering in a supplied sign or poster using exact Chinese or English copy. Specify the text position, font treatment, and background to retain.

### Recurring character illustrations

Use character references to request new scenes for a comic or illustrated campaign. Describe the identifying features to retain and the action in each scene.

### Illustration style studies

Start from an existing illustration and request a watercolor, painted, or photographic treatment. Describe the composition and subject details to carry into the new image.

### Reference-based storyboard exploration

Use a subject reference to explore a scene across wide, medium, and close-up compositions. Request a single storyboard image with clearly described panels.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All n8n guides](https://spiral.ai/integrations/n8n)

## HiDream O1 Image in other agents

- [Amp](https://spiral.ai/integrations/amp/hidream-o1-image)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/hidream-o1-image)
- [Claude](https://spiral.ai/integrations/claude-desktop/hidream-o1-image)
- [Claude Code](https://spiral.ai/integrations/claude-code/hidream-o1-image)
- [Cline](https://spiral.ai/integrations/cline/hidream-o1-image)
- [Codex](https://spiral.ai/integrations/codex/hidream-o1-image)
- [Cursor](https://spiral.ai/integrations/cursor/hidream-o1-image)
- [Devin](https://spiral.ai/integrations/devin/hidream-o1-image)
- [dots](https://spiral.ai/integrations/dots/hidream-o1-image)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/hidream-o1-image)
- [Gemini](https://spiral.ai/integrations/gemini/hidream-o1-image)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/hidream-o1-image)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/hidream-o1-image)
- [goose](https://spiral.ai/integrations/goose/hidream-o1-image)
- [Grok](https://spiral.ai/integrations/grok/hidream-o1-image)
- [Grok Build](https://spiral.ai/integrations/grok-build/hidream-o1-image)
- [Hermes](https://spiral.ai/integrations/hermes/hidream-o1-image)
- [Instinct](https://spiral.ai/integrations/instinct/hidream-o1-image)
- [Manus](https://spiral.ai/integrations/manus/hidream-o1-image)
- [Muse](https://spiral.ai/integrations/muse/hidream-o1-image)
- [Muse Code](https://spiral.ai/integrations/muse-code/hidream-o1-image)
- [Notion](https://spiral.ai/integrations/notion/hidream-o1-image)
- [OpenClaw](https://spiral.ai/integrations/openclaw/hidream-o1-image)
- [opencode](https://spiral.ai/integrations/opencode/hidream-o1-image)
- [Perplexity](https://spiral.ai/integrations/perplexity/hidream-o1-image)
- [Raycast](https://spiral.ai/integrations/raycast/hidream-o1-image)
- [VS Code](https://spiral.ai/integrations/vscode/hidream-o1-image)
- [Windsurf](https://spiral.ai/integrations/windsurf/hidream-o1-image)
- [Zapier](https://spiral.ai/integrations/zapier/hidream-o1-image)

## More n8n guides

- [HiDream I1 Full](https://spiral.ai/integrations/n8n/hidream-i1-full)
- [HiDream O1 Image Dev](https://spiral.ai/integrations/n8n/hidream-o1-image-dev)
- [HiDream I1 Fast](https://spiral.ai/integrations/n8n/hidream-i1-fast)
- [HiDream O1 Image Dev Edit](https://spiral.ai/integrations/n8n/hidream-o1-image-dev-edit)
- [Hi3D Image to Relief](https://spiral.ai/integrations/n8n/hi3d-image-to-relief)
- [HiDream O1 Image Edit](https://spiral.ai/integrations/n8n/hidream-o1-image-edit)

## Questions about HiDream O1 Image in n8n

**Can n8n use HiDream O1 Image?**

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run HiDream O1 Image like any built-in tool.

**How much does HiDream O1 Image cost in n8n?**

$0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your n8n plan is separate.

**Do I need a fal account to use HiDream O1 Image in n8n?**

You need no fal account. n8n uses one Spiral API key for every tool, and Spiral runs HiDream O1 Image on its own fal account.

**How long does it take to set up HiDream O1 Image in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while HiDream O1 Image runs?**

HiDream O1 Image runs in the background. n8n starts the run, checks on it and gives you the image when it's ready.

**What is HiDream O1 Image good at?**

Useful starting points include images with lettering, cinematic compositions, and illustrated storyboards. Reference-based work also includes editing pictures and placing a supplied subject into a different scene.

**How large can HiDream O1 Image outputs be?**

Outputs reach about 2048 × 2048 pixels. Reference-based results use the nearest supported resolution, so check the returned dimensions when an exact size matters.

**Can HiDream O1 Image render Chinese and English lettering?**

The maker's prompting guidance explicitly covers Chinese and English text. Put the exact wording in quotation marks and specify its font, color, and position.

**Can HiDream O1 Image keep a reference subject in a new scene?**

Subject-driven personalization is a supported task. Describe the new scene and explicitly identify the appearance details you want retained from the references.

**How should I describe the composition?**

Use concrete positions such as top left, centered in the foreground, or behind the subject. For lettering, include its exact wording and placement instead of asking for a generally attractive layout.

