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

Codex · Image

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.

Hair ChangeCodex
Try asking
  • 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

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. 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

  1. Send Codex 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 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.

falImage
Hair Change
fal-ai/image-apps-v2/hair-change

Settings you can ask for

Hair Change works from your image URL. Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Target hairstyleshort_hair, medium_long_hair, long_hair, curly_hair, wavy_hair, high_ponytail, bun, bob_cut and 10 morelong_hair
Hair colorblack, dark_brown, light_brown, blonde, platinum_blonde, red, auburn, gray and 10 morenatural

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.

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.

Get started

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 Codex

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