[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [fal Hair Change](https://spiral.ai/integrations/gemini-cli/fal-hair-change)

# How to Use fal Hair Change in Gemini CLI

fal Hair Change edits hairstyles in an existing image, including a completely bald look. Its focus is hair experimentation with natural lighting and realistic results.

|  |  |
| --- | --- |
| Model | fal Hair Change |
| Available through | fal |
| Category | Image |
| Price | $0.052 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with fal Hair Change in Gemini CLI

- Use fal Hair Change on the portrait in this project's assets folder to try a chin-length bob with blunt bangs. Save the result beside the original for review.
- Use fal Hair Change on our demo portrait to create a bald look. Add it to the hairstyle comparison page and label the requested edit.
- Use fal Hair Change to make three separate edits of the project's reference portrait: a pixie cut, shoulder-length waves, and long straight hair. Start each from the original and label the results.
- Use fal Hair Change on the project's sample portrait with the prompt 'short curls with a side part.' Save the prompt and returned seed alongside the image for a repeatability check.
- Use fal Hair Change to test two guidance values on the same project portrait with the same hairstyle prompt. Build a comparison view so I can inspect prompt adherence and unintended changes.

## How to set up fal Hair Change in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run fal Hair Change**: One request; the result comes back by polling or a webhook.

```bash
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-editing/hair-change",
    "input": {
      "image_url": "https://v3.fal.media/files/zebra/hAjCkcyly4gsS9-cptD3Y_image%20(20).png"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds fal Hair Change on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## fal Hair Change tools and prices

- [Image Editing Hair Change](https://spiral.ai/tools/fal/fal-ai/image-editing/hair-change) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| guidance_scale | 0 to 20 | 3.5 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |
| num_inference_steps | 1 to 50 | 30 | Number of inference steps for sampling. |
| safety_tolerance | 1, 2, 3, 4, 5, 6 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 6 being the most permissive. |
| output_format | jpeg, png | jpeg | The format of the generated image. |
| aspect_ratio | 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 | — | The aspect ratio of the generated image. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |

## What can you do with fal Hair Change in Gemini CLI?

Create hairstyle comparison assets from portraits in your project. Save each result beside its prompt so you can review the requested look against the edit.

### Haircut consultation

Try a bob, pixie cut, and shoulder-length cut on the same portrait before discussing the choices with a stylist.

### Bald look preview

Request a bald edit of a portrait to explore a different appearance before shaving.

### Bangs comparison

Compare blunt bangs and side-swept bangs on one portrait. Request the same hair length in both edits.

### Character appearance studies

Start with a character portrait and explore short curls, a close crop, or long straight hair for an appearance board.

### Photo shoot planning

Use a subject's reference portrait to explore hairstyle directions before a portrait or fashion shoot.

### Hairstyle comparison content

Create labeled hairstyle examples from a source portrait for a haircut guide. Inspect each edit before publishing.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## fal Hair Change in other agents

- [Amp](https://spiral.ai/integrations/amp/fal-hair-change)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/fal-hair-change)
- [Claude](https://spiral.ai/integrations/claude-desktop/fal-hair-change)
- [Claude Code](https://spiral.ai/integrations/claude-code/fal-hair-change)
- [Cline](https://spiral.ai/integrations/cline/fal-hair-change)
- [Codex](https://spiral.ai/integrations/codex/fal-hair-change)
- [Cursor](https://spiral.ai/integrations/cursor/fal-hair-change)
- [Devin](https://spiral.ai/integrations/devin/fal-hair-change)
- [dots](https://spiral.ai/integrations/dots/fal-hair-change)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/fal-hair-change)
- [Gemini](https://spiral.ai/integrations/gemini/fal-hair-change)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/fal-hair-change)
- [goose](https://spiral.ai/integrations/goose/fal-hair-change)
- [Grok](https://spiral.ai/integrations/grok/fal-hair-change)
- [Grok Build](https://spiral.ai/integrations/grok-build/fal-hair-change)
- [Hermes](https://spiral.ai/integrations/hermes/fal-hair-change)
- [Instinct](https://spiral.ai/integrations/instinct/fal-hair-change)
- [Manus](https://spiral.ai/integrations/manus/fal-hair-change)
- [Muse](https://spiral.ai/integrations/muse/fal-hair-change)
- [Muse Code](https://spiral.ai/integrations/muse-code/fal-hair-change)
- [n8n](https://spiral.ai/integrations/n8n/fal-hair-change)
- [Notion](https://spiral.ai/integrations/notion/fal-hair-change)
- [OpenClaw](https://spiral.ai/integrations/openclaw/fal-hair-change)
- [opencode](https://spiral.ai/integrations/opencode/fal-hair-change)
- [Perplexity](https://spiral.ai/integrations/perplexity/fal-hair-change)
- [Raycast](https://spiral.ai/integrations/raycast/fal-hair-change)
- [VS Code](https://spiral.ai/integrations/vscode/fal-hair-change)
- [Windsurf](https://spiral.ai/integrations/windsurf/fal-hair-change)
- [Zapier](https://spiral.ai/integrations/zapier/fal-hair-change)

## More Gemini CLI guides

- [fal Grain](https://spiral.ai/integrations/gemini-cli/fal-grain)
- [fal Object Removal](https://spiral.ai/integrations/gemini-cli/fal-object-removal)
- [fal Expression Change](https://spiral.ai/integrations/gemini-cli/fal-expression-change)
- [fal Retouch](https://spiral.ai/integrations/gemini-cli/fal-retouch)
- [fal Desaturate](https://spiral.ai/integrations/gemini-cli/fal-desaturate)
- [fal Scene Composition](https://spiral.ai/integrations/gemini-cli/fal-scene-composition)

## Questions about fal Hair Change in Gemini CLI

**Can Gemini CLI use fal Hair Change?**

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

**How much does fal Hair Change cost in Gemini CLI?**

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

**Do I need a fal account to use fal Hair Change in Gemini CLI?**

No. Spiral runs fal 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 fal Hair Change in Gemini CLI?**

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

**Does Gemini CLI wait while fal Hair Change runs?**

fal Hair Change runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

**What is fal Hair Change useful for?**

It changes hairstyles in an existing image. Try it for haircut previews, salon consultation images, or character appearance studies.

**Can fal Hair Change preview a bald look?**

Yes. Bald looks are explicitly included in fal's description, so a direct instruction such as “bald” is a supported starting point.

**How should I describe a hairstyle?**

Write a concrete target such as “chin-length bob with blunt bangs.” As a practical comparison method, change one detail at a time, such as length or part placement.

**Does fal Hair Change aim for realistic results?**

fal describes natural lighting and realistic results as its goals. Review the hairline, face, and background before choosing an edit.

**How can I repeat an edit?**

Keep the source image and settings unchanged, and reuse the same prompt and seed. fal documents repeatability for the same seed, prompt, and model version.

