How to Use Makeup Changer in Claude Code
Makeup Changer edits an existing portrait to preview makeup looks, including bridal makeup, smoky eyes, and bold lips. Adjust the intensity to compare subtle and stronger treatments before choosing a direction.
Prompts to try with Makeup Changer in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Makeup Changer on assets/portrait.png to create natural makeup previews at light and medium intensity.
Use Makeup Changer on the project's sample portrait to create a bridal reference, then add it to the comparison gallery.
Use Makeup Changer to make glamorous and smoky-eye edits from assets/portrait.png, keeping medium intensity for both.
Use Makeup Changer to create a bold-lip edit from the demo portrait and display it beside the original.
Use Makeup Changer to generate a makeup-removal preview from assets/portrait.png and label the result as an edited image.
How to set up Makeup Changer in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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
- 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
- Send Claude Code 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 Makeup Changer
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/makeup-application", "input": { "image_url": "https://v3.fal.media/files/elephant/jpdD30YLw3OfPdVDxq1-D_1ec2e27f3e7d400fbf5f7aa2b80e89f0.png" } }'
Then paste one of the prompts above: Claude Code finds Makeup Changer on Spiral, shows the price and runs it.
Makeup Changer providers and prices
Spiral runs Makeup Changer through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Makeup Changer works from your image URL. Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Makeup style | natural, glamorous, smoky_eyes, bold_lips, no_makeup, remove_makeup, dramatic, bridal and 3 more | natural | |
| Intensity | light, medium, heavy, or dramatic | medium |
Every API field of Makeup Changer is on its tool page: open its card above.
What can you do with Makeup Changer in Claude Code?
Create portrait comparisons for beauty app prototypes and consultation galleries. A coding agent can organize Makeup Changer results alongside the original images in your project.
Bridal consultation references
Preview bridal makeup on a portrait to prepare visual references for a consultation.
Everyday makeup planning
Try natural makeup on a portrait before choosing an everyday look.
Evening look comparisons
Compare glamorous makeup and smoky eyes on the same portrait for an upcoming event.
Bold lip concepts
Create a bold-lip portrait reference for a beauty shoot or personal styling session.
Makeup intensity studies
Arrange light, medium, and heavy treatments side by side to discuss the preferred strength.
Makeup-removal previews
Generate a makeup-removal edit and place it beside the source portrait for review.
More on Makeup Changer and Claude Code
Overview
Makeup Changer in other agents
Questions about Makeup Changer in Claude Code
Can Claude Code use Makeup Changer?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Makeup Changer like any built-in tool.
How much does Makeup Changer 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 Makeup Changer in Claude Code?
No. Spiral runs Makeup Changer on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Makeup Changer in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Makeup Changer runs?
Makeup Changer runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.
What is Makeup Changer useful for?
Use it to explore makeup directions on an existing portrait. Suggested uses include planning an event look or preparing references for a makeup consultation.
Can Makeup Changer remove makeup?
Yes, it includes a makeup-removal treatment. Compare the generated result with the original before using it as a reference.
How should I compare different makeup looks?
Reuse the same original portrait and hold intensity constant while comparing styles. Then test the preferred look at different intensities.
What resolution does Makeup Changer produce?
The documentation describes 4K output with a default 3:4 portrait shape. It does not state exact pixel dimensions for each shape.
How do I explore a subtle makeup look?
Start with natural makeup at light intensity. Compare it with a medium-intensity result from the same original portrait before deciding which to keep.
Start using Makeup Changer 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 https://spiral.ai/SKILL.md


