[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Expression Change](https://spiral.ai/integrations/windsurf/expression-change)

# How to Use Expression Change in Windsurf

Expression Change edits facial expressions in existing portraits for headshot choices, thumbnails, and reaction studies. It produces still portraits with named expressions and documented 4K output.

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

## Prompts to try with Expression Change in Windsurf

- Use Expression Change on the demo portrait in this project's assets to make separate confident and serious edits. Add a preview showing both beside the original.
- Use Expression Change to make happy, sad, and confused edits of the sample learner portrait. Build a local preview of the three feedback states.
- Use Expression Change on the project's presenter portrait to create excited and shocked edits. Show each in the existing thumbnail component.
- Use Expression Change to create focused and thoughtful edits from the project's sample headshot. Display both at the profile component's actual size.
- Use Expression Change on the demo customer portrait to make separate angry and confused edits. Add them to a review page with the original and label each requested expression.

## How to set up Expression Change in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 Expression Change**: 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/image-apps-v2/expression-change",
    "input": {
      "image_url": "https://v3.fal.media/files/kangaroo/Gk5_0En-p1CNYnGOCDkl1_8332b944f8334ba9b3118b49e3e641cf.png"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Expression Change on Spiral, shows the price and runs it.

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

## Expression Change tools and prices

- [Expression Change](https://spiral.ai/tools/fal/fal-ai/image-apps-v2/expression-change) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| target_expression | smile, surprise, glare, panic, shyness, laugh, cry, angry, sad, happy, excited, shocked, confused, focused, dreamy, serious, playful, mysterious, confident, thoughtful | smile |  |
| aspect_ratio |  | — | Aspect ratio for 4K output (default: 3:4 for portraits) |

## What can you do with Expression Change in Windsurf?

Create expression studies from portrait assets while working on a site or app. A coding agent can organize the edited images into a project preview for comparison.

### Headshot expression studies

Try confident and serious expressions on an existing headshot, then compare the results before choosing a profile portrait.

### Video thumbnail concepts

Edit a presenter portrait into excited and shocked expressions to explore which reaction suits a video's subject.

### Portrait ad concepts

Use happy and thoughtful edits of an existing portrait to compare the mood of two campaign layouts.

### Storyboard reaction references

Create separate angry, sad, and thoughtful edits from a portrait as visual references for a scene discussion.

### Training scenario illustrations

Edit a staged portrait into confused and focused expressions for draft customer-service training slides.

### Prototype reaction portraits

Prepare happy, sad, and confused portrait edits for testing how a learning app presents feedback.

## Overview

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

## Expression Change in other agents

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

## More Windsurf guides

- [EVF-SAM2](https://spiral.ai/integrations/windsurf/evf-sam2)
- [FASHN Virtual Try-On v1.5](https://spiral.ai/integrations/windsurf/fashn-virtual-try-on-v1-5)
- [Dodge Burn](https://spiral.ai/integrations/windsurf/dodge-burn)
- [FASHN Virtual Try-On v1.6](https://spiral.ai/integrations/windsurf/fashn-virtual-try-on-v1-6)
- [Dissolve](https://spiral.ai/integrations/windsurf/dissolve)
- [FIBO Edit 1.5](https://spiral.ai/integrations/windsurf/fibo-edit-1-5)

## Questions about Expression Change in Windsurf

**Can Windsurf use Expression Change?**

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

**How much does Expression Change cost in Windsurf?**

$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need a fal account to use Expression Change in Windsurf?**

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

**How long does it take to set up Expression Change in Windsurf?**

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

**Does Windsurf wait while Expression Change runs?**

Expression Change runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

**What is Expression Change useful for?**

Use it to explore different expressions in an existing portrait. Practical applications include headshot selection, thumbnail concepts, and reaction images.

**What resolution does Expression Change produce?**

The documentation describes 4K output but does not state exact pixel dimensions. Check the resulting image dimensions before preparing a final layout.

**Can I direct individual facial movements?**

The documented controls select a named expression; they do not establish control over individual muscles or expression intensity. For a precise acting brief, review the result against your reference.

**How should I compare different expressions?**

As a comparison workflow, start each edit from the same original portrait and request one expression at a time. View the results together at the intended display size.

**What should I check before using an edited portrait?**

Compare it with the original and inspect the eyes, mouth, facial shape, and surrounding details. Choose the result that communicates the intended mood and still looks right for the person pictured.

