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

# How to Use Portrait Enhance in Raycast

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, no API key |

## Prompts to try with Portrait Enhance in Raycast

- Use Portrait Enhance on this headshot for my professional profile. Show the original and result side by side.
- Use Portrait Enhance on this author portrait. Help me review facial detail before I choose a photo for my biography.
- Use Portrait Enhance on this speaker photo for a conference program. Report the result's pixel dimensions.
- Use Portrait Enhance on this performer portrait for a press kit. Flag any visible changes to the eyes, teeth, or facial contours.
- Use Portrait Enhance on this interview portrait. Compare the result at full size and at a small biography-photo size.

## How to set up Portrait Enhance in Raycast

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

### Use the Raycast connector

1. **Install the server**: In Raycast run Install MCP Server. Name it Spiral, set Transport to HTTP, paste this URL and keep OAuth Type on Dynamic:

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

2. **Sign in to Spiral and approve**: Spiral opens in your browser: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Raycast never sees it, and you can remove it under Settings › Connected apps in the console.

### Use the Spiral skill

1. **Send Raycast 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 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: Raycast finds Portrait Enhance on Spiral, shows the price and runs it.

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

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

Turn an existing portrait into a candidate for a profile, biography, or event program with Portrait Enhance. Ask the chat agent to help you compare the result with the original before choosing one.

### 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 Raycast guides](https://spiral.ai/integrations/raycast)

## 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)
- [n8n](https://spiral.ai/integrations/n8n/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)
- [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 Raycast guides

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

## Questions about Portrait Enhance in Raycast

**Can Raycast use Portrait Enhance?**

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

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

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

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

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

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

About two minutes: install the server, then sign in to Spiral and approve.

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

Portrait Enhance runs in the background. Raycast 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.

