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

# How to Use HiDream O1 Image in Amp

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, no API key |

## Prompts to try with HiDream O1 Image in Amp

- Use HiDream O1 Image to create a 1536 × 1024 illustration for this project's empty search state. Read the UI copy and theme colors, then depict a librarian inspecting an empty shelf, with the subject on the right and open space on the left.
- Read the event details in this project's content and use HiDream O1 Image to create a 1024 × 1536 poster concept. Put the exact event title at the top, the date beneath it, and the venue along the bottom.
- 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. Save the result in ./assets.
- 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 Amp

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

### Use Spiral's MCP server

1. **Add the server**: No header and no client ID or secret: Amp registers itself with Spiral.

```bash
amp mcp add spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `amp`. Amp opens Spiral's sign-in page in your browser: sign in, pick the organization and click Authorize. No API key.

3. **Check it**

```bash
amp mcp doctor
```

### Use the Spiral skill

1. **Send Amp 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 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: Amp finds HiDream O1 Image on Spiral, shows the price and runs it.

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

## 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 Amp?

Create or revise visual assets using the project's copy and existing artwork as context. A coding agent can turn those details into explicit HiDream O1 Image instructions for lettering, composition, and reference-based edits.

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

## HiDream O1 Image in other agents

- [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)
- [n8n](https://spiral.ai/integrations/n8n/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 Amp guides

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

## Questions about HiDream O1 Image in Amp

**Can Amp use HiDream O1 Image?**

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

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

$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 Amp plan is separate.

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

No. Spiral runs HiDream O1 Image 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 in Amp?**

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

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

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

