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

# How to Use HiDream O1 Image Edit in OpenClaw

Use HiDream O1 Image Edit to revise an existing picture or place a reference subject into a new scene. Unlike HiDream O1 Image, it starts from supplied images, making it a focused choice for product edits and character continuity.

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

## Prompts to try with HiDream O1 Image Edit in OpenClaw

- Each Friday, use HiDream O1 Image Edit with the supplied product reference to draft a seasonal scene. Retain the product's shape and markings, use soft side lighting, and make the output 2048 × 2048 pixels.
- Every Tuesday, use HiDream O1 Image Edit with the supplied mascot references to illustrate the approved activity of the week. Retain the mascot's face and clothing, use a watercolor treatment, and place the action in the center foreground.
- For each approved sign translation, use HiDream O1 Image Edit with the supplied sign image. Insert the exact approved wording, retain its existing placement and background, and preserve the original image proportions.
- Every Monday at 9am: remove the background from the photo I attach with HiDream O1 Image Edit and give me a transparent PNG.
- Use HiDream O1 Image Edit to clean up these product shots so they sit on pure white.

## How to set up HiDream O1 Image Edit in OpenClaw

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

### Use the Spiral skill

1. **Send OpenClaw 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. **Add the server**: On the machine that runs OpenClaw's Gateway:

```bash
openclaw mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --transport streamable-http \
  --auth oauth
```

2. **Sign in**: In Settings › MCP, select Sign in on the Spiral server, sign in to Spiral and click Authorize. No API key.

```bash
openclaw mcp login spiral
```

3. **Reload and check**: A running Gateway may keep its old tool list: restart it, or Save & Publish in the Control UI.

```bash
openclaw mcp reload
openclaw mcp doctor spiral --probe
```

### 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 Edit**: 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/edit",
    "input": {
      "prompt": "A cinematic product photo of a ceramic mug on a marble counter, soft window light, shallow depth of field.",
      "reference_image_urls": [
        "<reference_image_urls>"
      ]
    }
  }'
```

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

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

## HiDream O1 Image Edit tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | {"width":2048,"height":2048} | Requested output image size. Reference-image outputs use the nearest model-supported resolution 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. |
| output_format | jpeg, png, webp | png | The format of the generated image. |

## What can you do with HiDream O1 Image Edit in OpenClaw?

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.

### 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 OpenClaw guides](https://spiral.ai/integrations/openclaw)

## HiDream O1 Image Edit in other agents

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

## More OpenClaw guides

- [HiDream O1 Image Dev Edit](https://spiral.ai/integrations/openclaw/hidream-o1-image-dev-edit)
- [HunyuanImage 2.1](https://spiral.ai/integrations/openclaw/hunyuanimage-2-1)
- [HiDream O1 Image Dev](https://spiral.ai/integrations/openclaw/hidream-o1-image-dev)
- [HunyuanImage 3.0](https://spiral.ai/integrations/openclaw/hunyuanimage-3-0)
- [HiDream O1 Image](https://spiral.ai/integrations/openclaw/hidream-o1-image)
- [Ideogram 2.0](https://spiral.ai/integrations/openclaw/ideogram-2-0)

## Questions about HiDream O1 Image Edit in OpenClaw

**Can OpenClaw use HiDream O1 Image Edit?**

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

**How much does HiDream O1 Image Edit cost in OpenClaw?**

$0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Default 4 MP per image. 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 OpenClaw plan is separate.

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

No. Spiral runs HiDream O1 Image Edit on its own fal account. You sign in to Spiral once and never paste a key.

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

About two minutes: add the server, then sign in, then reload and check.

**Does OpenClaw wait while HiDream O1 Image Edit runs?**

HiDream O1 Image Edit runs in the background. OpenClaw 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.

