[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Dissolve](https://spiral.ai/integrations/opencode/dissolve)

# How to Use Dissolve in opencode

Dissolve blends two existing images using linear interpolation. Use it for photo overlays, intermediate edit strengths, and crossfade stills, with the blend factor controlling the mix.

|  |  |
| --- | --- |
| Model | Dissolve |
| Available through | fal |
| Category | Image |
| Price | $0.0013 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Dissolve in opencode

- Use Dissolve to blend the original and retouched product photos in assets/product at 0.5. Save the result beside the sources for review.
- Use Dissolve on the two aligned homepage renders in this project. Make a halfway overlay and inspect where the main outlines diverge.
- Use Dissolve to blend assets/portrait.png with assets/landscape.png at 0.25, 0.5, and 0.75. Build a labeled comparison image.
- Use Dissolve to create intermediate blends between the two slideshow images in assets/slides at 0.25, 0.5, and 0.75. Save each still separately.
- Use Dissolve to compare the original illustration and its textured edit in assets/art at 0.5. Show the blend beside both sources.

## How to set up Dissolve 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 Dissolve**: 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/post-processing/dissolve",
    "input": {
      "image_url": "https://v3.fal.media/files/elephant/pLQKJXcFdmIVvB2qhw7vv_59578fb9-8178-4f24-82f0-ea7ec5bc5f2d.jpg",
      "dissolve_image_url": "https://v3.fal.media/files/monkey/NJW5irDVP1qwoTMdwOcDV_39qXtqYS0zSUrFwbrJkOY.jpeg"
    }
  }'
```

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

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

## Dissolve tools and prices

- [Post Processing Dissolve](https://spiral.ai/tools/fal/fal-ai/post-processing/dissolve) (fal): $0.0013 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| dissolve_factor | 0 to 1 | 0.5 | Dissolve blend factor |

## What can you do with Dissolve in opencode?

Create blended project assets and visual comparisons from pairs of existing images. A coding agent can organize the results by source pair and blend setting for review.

### Soften a strong photo edit

Blend an original photo with its edited copy to explore an intermediate treatment.

### Prepare crossfade stills

Create intermediate blends between two pictures for later assembly in a slideshow or video editor.

### Explore photo overlays

Combine a portrait and a landscape as an overlay study, then inspect whether the face remains readable.

### Compare aligned design revisions

Blend two aligned renders of a design to inspect where their outlines overlap or diverge.

### Test texture treatments

Blend an illustration with a prepared texture image and compare several mixes before choosing a treatment.

### Review before-and-after photos

Overlay aligned photographs of the same scene to help a reviewer inspect changes in position or appearance.

## Overview

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

## Dissolve in other agents

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

## More opencode guides

- [DDColor](https://spiral.ai/integrations/opencode/ddcolor)
- [Dodge Burn](https://spiral.ai/integrations/opencode/dodge-burn)
- [Crystal Upscaler](https://spiral.ai/integrations/opencode/crystal-upscaler)
- [EVF-SAM2](https://spiral.ai/integrations/opencode/evf-sam2)
- [Color Tint](https://spiral.ai/integrations/opencode/color-tint)
- [Expression Change](https://spiral.ai/integrations/opencode/expression-change)

## Questions about Dissolve in opencode

**Can opencode use Dissolve?**

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

**How much does Dissolve cost in opencode?**

$0.0013 per image. 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 Dissolve in opencode?**

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

**How long does it take to set up Dissolve in opencode?**

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

**Does opencode wait while Dissolve runs?**

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

**What is Dissolve useful for?**

Use Dissolve to blend two existing pictures, soften an edit by mixing it with the original, or prepare still images for a crossfade.

**What does a halfway blend do?**

A halfway blend gives the two source images equal weight. This follows from Dissolve's documented linear interpolation.

**Why might a blend show doubled outlines?**

Linear blending can overlay subjects that occupy different positions. As a practical precaution, align important edges before blending and inspect faces, lettering, and product outlines afterward.

**Does Dissolve produce a finished crossfade video?**

The documented result is processed images. For a video crossfade, create intermediate blends and assemble them in a separate editing step.

**How should I describe a Dissolve task to an agent?**

Identify both source images, state the desired mix, and explain what to inspect in the result. For example, request a halfway blend and ask the agent to check whether the subject's outline remains readable.

