[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Makeup Changer](https://spiral.ai/integrations/gemini-cli/makeup-changer)

# How to Use Makeup Changer in Gemini CLI

Makeup Changer edits an existing portrait to preview makeup looks, including bridal makeup, smoky eyes, and bold lips. Adjust the intensity to compare subtle and stronger treatments before choosing a direction.

|  |  |
| --- | --- |
| Model | Makeup Changer |
| 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 Makeup Changer in Gemini CLI

- Use Makeup Changer on assets/portrait.png to create natural makeup previews at light and medium intensity.
- Use Makeup Changer on the project's sample portrait to create a bridal reference, then add it to the comparison gallery.
- Use Makeup Changer to make glamorous and smoky-eye edits from assets/portrait.png, keeping medium intensity for both.
- Use Makeup Changer to create a bold-lip edit from the demo portrait and display it beside the original.
- Use Makeup Changer to generate a makeup-removal preview from assets/portrait.png and label the result as an edited image.

## How to set up Makeup Changer 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 Makeup Changer**: 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-apps-v2/makeup-application",
    "input": {
      "image_url": "https://v3.fal.media/files/elephant/jpdD30YLw3OfPdVDxq1-D_1ec2e27f3e7d400fbf5f7aa2b80e89f0.png"
    }
  }'
```

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

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

## Makeup Changer tools and prices

- [Makeup Changer](https://spiral.ai/tools/fal/fal-ai/image-apps-v2/makeup-application) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| makeup_style | natural, glamorous, smoky_eyes, bold_lips, no_makeup, remove_makeup, dramatic, bridal, professional, korean_style, artistic | natural |  |
| intensity | light, medium, heavy, dramatic | medium |  |
| aspect_ratio |  | — | Aspect ratio for 4K output (default: 3:4 for portraits) |

## What can you do with Makeup Changer in Gemini CLI?

Create portrait comparisons for beauty app prototypes and consultation galleries. A coding agent can organize Makeup Changer results alongside the original images in your project.

### Bridal consultation references

Preview bridal makeup on a portrait to prepare visual references for a consultation.

### Everyday makeup planning

Try natural makeup on a portrait before choosing an everyday look.

### Evening look comparisons

Compare glamorous makeup and smoky eyes on the same portrait for an upcoming event.

### Bold lip concepts

Create a bold-lip portrait reference for a beauty shoot or personal styling session.

### Makeup intensity studies

Arrange light, medium, and heavy treatments side by side to discuss the preferred strength.

### Makeup-removal previews

Generate a makeup-removal edit and place it beside the source portrait for review.

## Overview

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

## Makeup Changer in other agents

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

## More Gemini CLI guides

- [MOSS Image](https://spiral.ai/integrations/gemini-cli/moss-image)
- [Marigold V2](https://spiral.ai/integrations/gemini-cli/marigold-v2)
- [MAI Image 2.5](https://spiral.ai/integrations/gemini-cli/mai-image-2-5)
- [MiniMax H3 Image Edit](https://spiral.ai/integrations/gemini-cli/minimax-h3-image-edit)
- [Luma Uni-1 Text to Image](https://spiral.ai/integrations/gemini-cli/luma-uni-1-text-to-image)
- [MiniMax H3 Image Highspeed Edit](https://spiral.ai/integrations/gemini-cli/minimax-h3-image-highspeed-edit)

## Questions about Makeup Changer in Gemini CLI

**Can Gemini CLI use Makeup Changer?**

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

**How much does Makeup Changer 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 Makeup Changer in Gemini CLI?**

No. Spiral runs Makeup Changer on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Makeup Changer in Gemini CLI?**

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

**Does Gemini CLI wait while Makeup Changer runs?**

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

**What is Makeup Changer useful for?**

Use it to explore makeup directions on an existing portrait. Suggested uses include planning an event look or preparing references for a makeup consultation.

**Can Makeup Changer remove makeup?**

Yes, it includes a makeup-removal treatment. Compare the generated result with the original before using it as a reference.

**How should I compare different makeup looks?**

Reuse the same original portrait and hold intensity constant while comparing styles. Then test the preferred look at different intensities.

**What resolution does Makeup Changer produce?**

The documentation describes 4K output with a default 3:4 portrait shape. It does not state exact pixel dimensions for each shape.

**How do I explore a subtle makeup look?**

Start with natural makeup at light intensity. Compare it with a medium-intensity result from the same original portrait before deciding which to keep.

