[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Portrait Enhance](https://spiral.ai/integrations/n8n/portrait-enhance)

# How to Use Portrait Enhance in n8n

Portrait Enhance refines portrait photos for improved clarity and detail. Its documented 4K output makes it worth testing for headshots, author photos, and speaker portraits.

|  |  |
| --- | --- |
| Model | Portrait Enhance |
| Available through | fal |
| Category | Image |
| Price | $0.52 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Portrait Enhance in n8n

- Every Monday, use Portrait Enhance on newly submitted staff portraits. Put originals and results in a review gallery.
- Each morning, use Portrait Enhance on new speaker photos submitted for the conference. Include the returned pixel dimensions in the review report.
- Every Friday, use Portrait Enhance on newly approved author portraits. Prepare a before-and-after digest for the editor.
- Each evening, use Portrait Enhance on new performer portraits submitted for the press kit. Keep each result paired with its original.
- Every Wednesday, use Portrait Enhance on new interview subject portraits. Flag visible facial changes for editorial review.

## How to set up Portrait Enhance in n8n

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

### Use the Spiral skill

1. **Send n8n 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 a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run Portrait Enhance in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Portrait Enhance, prices it and runs it each time the step fires.

### 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 Portrait Enhance**: 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/portrait-enhance",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/monkey/VszUszGx2uzReqFvQzF26.jpg"
    }
  }'
```

Then paste one of the prompts above: n8n finds Portrait Enhance on Spiral, shows the price and runs it.

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

## Portrait Enhance tools and prices

- [Portrait Enhance](https://spiral.ai/tools/fal/fal-ai/image-apps-v2/portrait-enhance) (fal): $0.52 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| aspect_ratio |  | — | Aspect ratio for 4K output (default: 3:4 for portraits) |

## What can you do with Portrait Enhance in n8n?

Prepare portrait review candidates as new staff, speaker, or author photos arrive with Portrait Enhance. A scheduled agent can collect the results into a comparison report for an editor.

### Team directory portraits

Refine existing employee portraits, then review each result before placing it in the team directory.

### Author biography photos

Prepare an enhanced version of an author's portrait for a book page, newsletter, or article biography.

### Conference speaker photos

Improve portrait clarity for speaker biographies and compare the results before adding names and session details.

### Professional profile updates

Test an enhanced version of an existing headshot for a professional profile, keeping the original for comparison.

### Performer press portraits

Refine a musician's or actor's existing portrait for review alongside the other images in a press kit.

### Interview subject portraits

Prepare portrait candidates for an interview page and check facial detail before the editor selects an image.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All n8n guides](https://spiral.ai/integrations/n8n)

## Portrait Enhance in other agents

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

## More n8n guides

- [Plushie Style](https://spiral.ai/integrations/n8n/plushie-style)
- [Post Processing Color Correction](https://spiral.ai/integrations/n8n/post-processing-color-correction)
- [Pixelcut Product Photo](https://spiral.ai/integrations/n8n/pixelcut-product-photo)
- [Product Holding](https://spiral.ai/integrations/n8n/product-holding)
- [Pixelcut Background Remover](https://spiral.ai/integrations/n8n/pixelcut-background-remover)
- [Product Photography](https://spiral.ai/integrations/n8n/product-photography)

## Questions about Portrait Enhance in n8n

**Can n8n use Portrait Enhance?**

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run Portrait Enhance like any built-in tool.

**How much does Portrait Enhance cost in n8n?**

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

**Do I need a fal account to use Portrait Enhance in n8n?**

You need no fal account. n8n uses one Spiral API key for every tool, and Spiral runs Portrait Enhance on its own fal account.

**How long does it take to set up Portrait Enhance in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while Portrait Enhance runs?**

Portrait Enhance runs in the background. n8n starts the run, checks on it and gives you the image when it's ready.

**What is Portrait Enhance good for?**

Its stated purpose is improving clarity and detail in portrait photos. Try it on an existing headshot or biography photo, then compare the result with the original.

**What resolution does Portrait Enhance produce?**

The documentation specifies 4K output. Check the returned image dimensions before preparing a final layout.

**How do I check the exact output dimensions?**

Read the returned image's width and height in pixels. Use those measurements when deciding how large to place the portrait.

**How should I check whether the portrait still looks like the person?**

Compare the original and result side by side, paying attention to eyes, teeth, skin texture, and facial contours. Keep the original if the changes make the person look less recognizable.

**What should I ask my agent to do with Portrait Enhance?**

Name the portrait and its intended use, such as an author bio or conference program. Ask the agent to show a before-and-after comparison and flag visible changes before you approve the result.

