[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Boogu Image](https://spiral.ai/integrations/n8n/boogu-image)

# How to Use Boogu Image in n8n

Boogu Image creates posters, document layouts, photos, and illustrations from text, with support for Chinese and English lettering. Use detailed descriptions, and proofread dense text for missing characters or layout errors.

|  |  |
| --- | --- |
| Model | Boogu Image |
| Available through | fal |
| Category | Image |
| Price | $0.052 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 Boogu Image in n8n

- Every Monday, use Boogu Image to make a square editorial illustration for the week's newsletter theme. Choose one concrete visual metaphor, describe its composition in detail, and include no lettering.
- Each Friday, use Boogu Image to draft a portrait poster for the next confirmed community event. Include only its approved short title, place one illustration underneath, and return the draft for review.
- For each approved bilingual campaign brief, use Boogu Image to make a square poster. Use the supplied Chinese and English headlines exactly, keep them large, and place a simple illustrated scene below.
- Once a month, use Boogu Image to make a wide photographic cover concept for the editorial calendar's lead topic. Specify one scene, its light source, and its focal subject. Leave out text.
- For each new reading-club selection, use Boogu Image to create a portrait discussion-poster concept. Use the approved short heading and a symbolic ink illustration, with ample space between text and artwork.

## How to set up Boogu 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 Boogu Image in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Boogu 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 Boogu 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/boogu-image",
    "input": {
      "prompt": "A street photography shot of an elderly scavenger with a deeply weathered face in the center of the frame, a trash can and a traffic light in the background.…"
    }
  }'
```

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

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

## Boogu Image tools and prices

- [Boogu Image · Text to Image](https://spiral.ai/tools/fal/fal-ai/boogu-image) (fal): $0.052 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 |
| --- | --- | --- | --- |
| negative_prompt |  |  | Describes what should NOT appear in the image. Used for classifier-free guidance; leave empty to disable text negative guidance. |
| image_size |  | square_hd | The size of the generated image. The model's maximum native resolution is 2K; larger requests are clamped. Dimensions are aligned to multiples of 16. |
| num_inference_steps | 20 to 50 | 30 | The number of denoising steps to perform. |
| guidance_scale | 1 to 8 | 4 | Controls how closely generation follows the text instruction. Higher values stick more closely to the prompt. A value of 1.0 disables text classifier-free guidance. |
| cfg_range_start | 0 to 1 | 0 | Start of the timestep fraction over which CFG is applied. |
| cfg_range_end | 0 to 1 | 1 | End of the timestep fraction over which CFG is applied. |

## What can you do with Boogu Image in n8n?

Prepare recurring visual drafts from fresh written briefs with Boogu Image. An always-on agent can generate scheduled poster or editorial concepts and collect them for review.

### Event poster concepts

Draft a poster from an event description, with a clear headline and a small amount of supporting copy. Check every date and letter before using it.

### Chinese and English campaign artwork

Explore artwork containing supplied Chinese and English headlines. Specify the placement and relative size of each language.

### Document layout studies

Test the visual hierarchy of a title page or short information sheet before rebuilding the chosen layout in a document editor.

### Brand guide concepts

Explore a brand guide page using a written palette, typography direction, and short sample headings.

### Editorial photo concepts

Turn a written article brief into a photographic scene with specified framing, lighting, and background details.

### Illustrated covers

Explore a cover in a chosen artistic medium, with a defined focal subject and space for the title.

## Overview

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

## Boogu Image in other agents

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

## More n8n guides

- [Background Change](https://spiral.ai/integrations/n8n/background-change)
- [Bria Background Replace](https://spiral.ai/integrations/n8n/bria-background-replace)
- [Baby Version](https://spiral.ai/integrations/n8n/baby-version)
- [Bria Creative Upscale](https://spiral.ai/integrations/n8n/bria-creative-upscale)
- [BEN v2](https://spiral.ai/integrations/n8n/ben-v2)
- [Bria Embed Product](https://spiral.ai/integrations/n8n/bria-embed-product)

## Questions about Boogu Image in n8n

**Can n8n use Boogu Image?**

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

**How much does Boogu Image cost in n8n?**

$0.052 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 Boogu Image in n8n?**

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

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

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

**Does n8n wait while Boogu Image runs?**

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

**What is Boogu Image useful for?**

Try posters, document concepts, bilingual lettering, editorial photos, and illustrated covers. Describe the intended layout as carefully as the subject.

**Can Boogu Image write Chinese and English in an image?**

Yes. It supports Chinese and English text rendering, though generated lettering still needs proofreading before use.

**How large can Boogu Image generate?**

Its maximum native resolution is 2K. Asking for a larger image is clamped to that limit.

**Why does Boogu Image sometimes misspell text?**

Long passages, small fonts, dense typography, and complex layouts remain documented weaknesses. Shorten the copy and simplify the layout when letters go missing or text shifts.

**How should I prompt Boogu Image?**

Use a detailed description of the subject, composition, lighting, colors, and intended lettering. For example, specify where a headline belongs and provide its exact wording.

