How to Use Hair Change in Codex
Hair Change previews hairstyle and color changes on an existing portrait. Use it to compare cuts, textures, and shades before choosing a look.
Prompts to try with Hair Change in Codex
Copy an example into Codex, or ask in your own words.
Use Hair Change on the project's sample portrait to preview a dark brown bob, then add it to the comparison screen.
Use Hair Change to create curly and wavy previews from the same project portrait, both blonde. Label the results.
Use Hair Change on the demo portrait to compare black, auburn, and gray long hair. Build a review gallery.
Use Hair Change to preview a bun and a high ponytail on the sample portrait. Place both beside the original.
Use Hair Change on the project's portrait to create a platinum blonde bob. Record the returned dimensions beside the image.
How to set up Hair Change in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex 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 Hair 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/hair-change", "input": { "image_url": "https://v3.fal.media/files/zebra/1ois7lqES78dLualcytmS_1e088ef24f474972824cffcfdd7ff291.png" } }'
Then paste one of the prompts above: Codex finds Hair Change on Spiral, shows the price and runs it.
Hair Change providers and prices
Spiral runs Hair Change through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Hair Change works from your image URL. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Target hairstyle | short_hair, medium_long_hair, long_hair, curly_hair, wavy_hair, high_ponytail, bun, bob_cut and 10 more | long_hair | |
| Hair color | black, dark_brown, light_brown, blonde, platinum_blonde, red, auburn, gray and 10 more | natural |
Every API field of Hair Change is on its tool page: open its card above.
What can you do with Hair Change in Codex?
Create hairstyle comparison assets for a salon prototype or portrait editor. Have the coding agent organize Hair Change results beside the original for review.
Haircut consultation
Preview short hair, a bob, and long hair on one portrait to discuss with a stylist.
Color appointment planning
Build a portrait comparison of brunette, blonde, and auburn looks before an appointment.
Texture exploration
Compare curly and wavy looks using the same starting photo.
Event hair planning
Preview a bun and a high ponytail to help choose an event look.
Photo shoot concepts
Create hair color studies from a model's portrait for a shoot planning board.
Gray hair preview
Try a gray hair edit on an existing portrait as a visual reference.
More on Hair Change and Codex
Overview
Hair Change in other agents
Questions about Hair Change in Codex
Can Codex use Hair Change?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Hair Change like any built-in tool.
How much does Hair Change cost in Codex?
$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need a fal account to use Hair Change in Codex?
No. Spiral runs Hair 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 Hair Change in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Hair Change runs?
Hair Change runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.
What is Hair Change useful for?
Previewing hairstyle and hair color changes on a portrait. Use the results to build a shortlist for a haircut, color appointment, or photo concept.
Does Hair Change need a photo?
Yes. Hair Change requires an existing portrait to edit.
What resolution does Hair Change produce?
The documentation describes 4K output, with 3:4 as the default portrait shape.
Does 4K mean every result is 4096 pixels wide?
The documentation does not establish a fixed 4096-pixel width. Check the returned image dimensions before planning a crop or print.
How should I compare different looks?
Use the same original portrait for each edit. Compare styles with one color first, then compare colors on your preferred style.
Start using Hair Change in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


