[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Topaz Adjust Image](https://spiral.ai/integrations/opencode/topaz-adjust-image)

# How to Use Topaz Adjust Image in opencode

Topaz Adjust Image corrects exposure and color casts or adds color to black-and-white photos. It preserves the original resolution, making it useful for correcting existing photos before publishing.

|  |  |
| --- | --- |
| Model | Topaz Adjust Image |
| 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 Adjust Image in opencode

- Use Topaz Adjust Image with Adjust V2 on the dim room photos in this project's listing assets. Save corrected copies and build a review page showing each original beside its result.
- Use Topaz Adjust Image with White Balance on the product photos marked as having a color cast in the asset manifest. Keep the originals and prepare a comparison gallery.
- Use Topaz Adjust Image with Colorize on the black-and-white portraits in the archive directory. Add original-and-colorized comparisons to the history page and label the new colors as interpretations.
- Use Topaz Adjust Image with Adjust V2 on the poorly exposed travel photos selected for the gallery. Record the input and output pixel dimensions in the review report.
- Use Topaz Adjust Image with White Balance on the indoor event photos in this project. Build a contact sheet of originals and results for checking skin tones and neutral objects.

## How to set up Topaz Adjust Image 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 Adjust 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": "topaz/adjust/image",
    "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 Adjust Image on Spiral, shows the price and runs it.

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

## Topaz Adjust Image tools and prices

- [Topaz Adjust Image](https://spiral.ai/tools/fal/topaz/adjust/image) (fal): Up to $0.104 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| output_format | jpeg, png | jpeg | Output format of the processed image. |
| model | Adjust V2, White Balance, Colorize | Adjust V2 | Color & lighting correction. Adjust V2 fixes exposure/lighting; White Balance corrects color; Colorize adds color to B&W images. |

## What can you do with Topaz Adjust Image in opencode?

Prepare existing project photos for product pages and image galleries. Have the agent apply lighting or color correction and build a comparison view for review.

### Correct dim listing photos

Use Topaz Adjust Image to correct exposure in property photos before choosing images for a listing. Review the corrected rooms beside the originals.

### Remove color casts from product photos

Apply white-balance correction to product shots with an unwanted tint. Check the result against the product before approving it for a catalog.

### Review indoor event photos

Correct unwanted color casts in indoor event pictures, then compare skin tones and neutral objects with the originals.

### Correct exposure in travel photos

Apply lighting correction to poorly exposed travel pictures before assembling a gallery. Keep the original pixel dimensions throughout the correction stage.

### Colorize scanned portraits

Create color interpretations of black-and-white portraits for a personal photo collection. Choose clear scans with good contrast and retain the originals.

### Prepare historical photo comparisons

Colorize archival street scenes for an original-and-colorized comparison. Label the colorized images as interpretations when presenting them.

## Overview

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

## Topaz Adjust Image in other agents

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

## More opencode guides

- [Texture Transform](https://spiral.ai/integrations/opencode/texture-transform)
- [Topaz Bloom 2](https://spiral.ai/integrations/opencode/topaz-bloom-2)
- [Solarize](https://spiral.ai/integrations/opencode/solarize)
- [Topaz Denoise Image](https://spiral.ai/integrations/opencode/topaz-denoise-image)
- [Smart Resize](https://spiral.ai/integrations/opencode/smart-resize)
- [Topaz Generative Upscale](https://spiral.ai/integrations/opencode/topaz-generative-upscale)

## Questions about Topaz Adjust Image in opencode

**Can opencode use Topaz Adjust Image?**

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

**How much does Topaz Adjust Image 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 Adjust Image in opencode?**

No. Spiral runs Topaz Adjust 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 Topaz Adjust Image in opencode?**

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

**Does opencode wait while Topaz Adjust Image runs?**

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

**Does Topaz Adjust Image make photos larger?**

It keeps the source resolution. A 3000 × 2000 photo remains 3000 × 2000 after correction.

**How does Topaz Adjust Image correct lighting?**

Topaz's lighting correction considers each pixel and its surrounding context. Adjust V2 adapts to the image's lighting requirements, so it does more than apply the same brightness change everywhere.

**Should I correct lighting or white balance?**

For a photo that is too dark or poorly exposed, start with lighting correction. If the brightness looks right but whites look tinted, start with white-balance correction.

**Which photos are harder to colorize?**

Heavily damaged, very dark, and extremely low-resolution photos can produce less precise colors. Start with the clearest available scan, with a recognizable subject and good contrast.

**Should I treat colorized historical photos as proof of the original colors?**

Topaz describes assigning hues from scene content. The practical implication is to treat the result as a color interpretation and check historical color claims against reference material.

