[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Makeup Changer](https://spiral.ai/integrations/codex/makeup-changer)

# How to Use Makeup Changer in Codex

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 Codex

- 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 Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
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.

```bash
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.

```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: Codex finds Makeup Changer on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## 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 Codex?

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 Codex guides](https://spiral.ai/integrations/codex)

## 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)
- [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)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/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 Codex guides

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

## Questions about Makeup Changer in Codex

**Can Codex use Makeup Changer?**

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

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

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 Codex?**

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

**Does Codex wait while Makeup Changer runs?**

Makeup Changer runs in the background. Codex 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.

