Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · Image

How to Use Expression Change in Claude Code

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 Claude Code

Copy an example into Claude Code, 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.

Expression ChangeClaude Code
Try asking
  • 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 Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code 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.

    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.

    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: Claude Code 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.

falImage
Expression Change
fal-ai/image-apps-v2/expression-change

Settings you can ask for

Expression Change works from your image URL. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Target expressionsmile, surprise, glare, panic, shyness, laugh, cry, angry and 12 moresmile

Every API field of Expression Change is on its tool page: open its card above.

What can you do with Expression Change in Claude Code?

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.

Questions about Expression Change in Claude Code

Can Claude Code use Expression Change?

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

How much does Expression Change cost in Claude Code?

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

Do I need a fal account to use Expression Change in Claude Code?

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 Claude Code?

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

Does Claude Code wait while Expression Change runs?

Expression Change runs in the background. Claude Code 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.

Get started

Start using Expression Change in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options