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.
Prompts to try with Expression Change in Windsurf
Copy an example into Windsurf, or ask in your own words.
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
- 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:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - 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.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Expression Change
One request; the result comes back by polling or a webhook.
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.
Expression Change providers and prices
Spiral runs Expression Change through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Expression Change works from your image URL. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Target expression | smile, surprise, glare, panic, shyness, laugh, cry, angry and 12 more | smile |
Every API field of Expression Change is on its tool page: open its card above.
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.
More on Expression Change and Windsurf
Overview
Expression Change in other agents
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.
Start using Expression Change in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


