[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Topaz Bloom 2](https://spiral.ai/integrations/opencode/topaz-bloom-2)

# How to Use Topaz Bloom 2 in opencode

Topaz Bloom 2 enlarges AI artwork, illustrations, and CG renders while adding new texture and detail. Compared with Bloom, it reduces anatomical errors such as extra fingers, though stronger creativity can still introduce artifacts.

|  |  |
| --- | --- |
| Model | Topaz Bloom 2 |
| Available through | fal |
| Category | Image |
| Price | Up to $0.104 per run at the default inputs. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Topaz Bloom 2 in opencode

- Use Topaz Bloom 2 to upscale the AI illustration in public/images/hero.png by 2x with creativity 2 and color preservation enabled. Save a separate candidate and build a side-by-side comparison with the original.
- Use Topaz Bloom 2 on the CG environment render in assets/concept/environment.png at 2x enlargement and creativity 3. Keep the original and add a zoomable comparison page for reviewing the generated surface detail.
- Use Topaz Bloom 2 to make two 2x enlargements of assets/art/cover.png, using creativity 2 and 6. Label both results and show them beside the source so I can choose the amount of reinterpretation.
- Use Topaz Bloom 2 on the AI character illustration in assets/characters/explorer.png at 2x enlargement and creativity 2. Create a review view with close-ups of the face, hands, and body proportions.
- Use Topaz Bloom 2 to enlarge the generated campaign illustration in public/images/campaign.png by 2x with color preservation enabled and creativity 2. Add an original-versus-output toggle to the asset preview.

## How to set up Topaz Bloom 2 in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Topaz Bloom 2**: 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": "topaz/upscale/image/creative",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg"
    }
  }'
```

Then paste one of the prompts above: opencode finds Topaz Bloom 2 on Spiral, shows the price and runs it.

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

## Topaz Bloom 2 tools and prices

- [Topaz Upscale Image Creative · Upscale Image Creative ( Bloom 2 )](https://spiral.ai/tools/fal/topaz/upscale/image/creative) (fal): Up to $0.104 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| model | Bloom 2, Bloom, Bloom Realism | Bloom 2 | Creative (Bloom) upscaling model. Bloom 2 is the latest and most capable; Bloom creatively upscales and transforms AI-generated images; Bloom Realism biases the added detail toward photorealism. |
| upscale_factor | 1 to 4 | 2 | Factor to upscale the image by (e.g. 2.0 doubles width and height) |
| autoprompt |  | — | Enable automatic prompt generation. Applies to Bloom 2 only; Topaz defaults it to true when omitted. |
| creativity | 1 to 9 | — | Creativity level (1-9). Higher values produce more creative/hallucinated details. Applies to Bloom 2 only. |
| color_preservation |  | — | Preserve the source image's colors in the output. Applies to Bloom 2 only. |
| crop_to_fill |  | false |  |

## What can you do with Topaz Bloom 2 in opencode?

Turn existing AI illustrations and CG renders into larger assets for a project with Topaz Bloom 2. A coding agent can prepare candidate outputs and a comparison view so you can review texture, color, and anatomy before replacing an asset.

### Enlarge illustrated website artwork

Use Topaz Bloom 2 on an existing AI illustration intended for a website hero. Start with low creativity and compare the added textures with the approved artwork.

### Prepare generated art for print review

Enlarge AI artwork with Topaz Bloom 2 for a poster or art print proof. Inspect the generated detail at full size before approving the print.

### Develop CG presentation images

Apply Topaz Bloom 2 to a CG render when additional surface texture is welcome. Compare the result with the render before using it in a presentation.

### Explore concept art treatments

Run an existing concept image through Topaz Bloom 2 at different creativity levels. Use the results to choose how much reinterpretation suits the art direction.

### Enlarge generated character illustrations

Use Topaz Bloom 2 to add detail to AI character artwork for a pitch deck or character sheet. Review hands, faces, and proportions before selecting an output.

### Add detail while retaining an approved palette

Process an existing campaign illustration with Topaz Bloom 2 and color preservation enabled. Review the new textures alongside the original palette.

## Overview

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

## Topaz Bloom 2 in other agents

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

## More opencode guides

- [Topaz Adjust Image](https://spiral.ai/integrations/opencode/topaz-adjust-image)
- [Topaz Denoise Image](https://spiral.ai/integrations/opencode/topaz-denoise-image)
- [Texture Transform](https://spiral.ai/integrations/opencode/texture-transform)
- [Topaz Generative Upscale](https://spiral.ai/integrations/opencode/topaz-generative-upscale)
- [Solarize](https://spiral.ai/integrations/opencode/solarize)
- [Topaz Restore Image](https://spiral.ai/integrations/opencode/topaz-restore-image)

## Questions about Topaz Bloom 2 in opencode

**Can opencode use Topaz Bloom 2?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Topaz Bloom 2 like any built-in tool.

**How much does Topaz Bloom 2 cost in opencode?**

Up to $0.104 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need a fal account to use Topaz Bloom 2 in opencode?**

No. Spiral runs Topaz Bloom 2 on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Topaz Bloom 2 in opencode?**

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

**Does opencode wait while Topaz Bloom 2 runs?**

Topaz Bloom 2 runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.

**What images is Topaz Bloom 2 best suited for?**

Start with AI-generated artwork, illustrations, or CG renders that would benefit from added texture and detail. It suits projects where some creative interpretation is welcome.

**Does Topaz Bloom 2 recover the original missing detail?**

Treat added detail as generated interpretation. For work that requires exact source fidelity, creative upscaling is a poor fit.

**How should I choose the creativity level?**

Start low when the composition and subject already work. Raise creativity when you want more reinterpretation, then inspect the result for invented details and artifacts.

**Can Topaz Bloom 2 keep the original colors?**

Use color preservation when the source palette matters. Compare the result with the original before accepting it.

**Can Topaz Bloom 2 still distort hands or anatomy?**

Yes. Topaz reports fewer anatomical artifacts than earlier creative upscaling, but higher creativity still increases artifact risk; check hands and body proportions before using the output.

