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

opencode · Image

How to Use Hair Change in opencode

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 opencode

Copy an example into opencode, 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 Changeopencode
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 opencode

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

Use Spiral's MCP server

  1. Add the server

    Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

    opencode mcp add spiral --global --url https://api.spiral.ai/mcp
  2. Sign in

    Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    opencode mcp list

Use the Spiral skill

  1. Send opencode 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: opencode 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 opencode 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 opencode?

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 opencode

Can opencode use Hair Change?

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

How much does Hair Change cost in opencode?

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

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

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 opencode?

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

Does opencode wait while Hair Change runs?

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

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

Paste this into opencode:

Set up opencode

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