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

dots · Image

How to Use Hair Change in dots

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 dots

Copy an example into dots, or ask in your own words.

Each Monday, use Hair Change on new consultation portraits to preview dark brown short hair and bobs. Prepare a labeled review set.

Hair Changedots
Try asking
  • Each morning, use Hair Change on newly submitted portraits requesting color ideas to compare blonde and auburn long hair.

  • Every Friday, use Hair Change on new event consultation portraits to compare a black bun and a black high ponytail.

  • Each week, use Hair Change on new texture consultation portraits to compare curly and wavy hair, both light brown.

  • Each morning, use Hair Change on new gray-preview requests to create gray long-hair portraits. Pair each result with its original.

How to set up Hair Change in dots

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

Use the Spiral skill

  1. Send dots 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 Spiral's MCP server

  1. Create an API key

    In the console, open API keys and create a key for your dot. Copy it.

  2. Send your dot this message

    Your dot reads Spiral's skill and asks for your API key.

    set up https://spiral.ai/SKILL.md
  3. Give your dot the key

    When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

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: dots 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 dots 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 dots?

Prepare recurring hairstyle review sets from incoming portraits. A scheduled agent can organize Hair Change previews by person and requested look.

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 dots

Can dots use Hair Change?

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

How much does Hair Change cost in dots?

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

Do I need a fal account to use Hair Change in dots?

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs Hair Change on its own fal account.

How long does it take to set up Hair Change in dots?

About two minutes: create an API key, then send your dot this message, then give your dot the key.

Does dots wait while Hair Change runs?

Hair Change runs in the background. dots 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 dots

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

Paste this into dots:

Set up dots

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