[Integrations](https://spiral.ai/integrations) › [VS Code](https://spiral.ai/integrations/vscode) › [Phota Enhance](https://spiral.ai/integrations/vscode/phota-enhance)

# How to Use Phota Enhance in VS Code

Phota Enhance improves lighting, color, and composition in existing photos without a written editing prompt. Supply the relevant trained profiles when the people in the photo need to stay recognizable.

|  |  |
| --- | --- |
| Model | Phota Enhance |
| Available through | fal |
| Category | Image |
| Price | $0.169 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Phota Enhance in VS Code

- Use Phota Enhance on the dim event photos in public/photos/events. Save separate copies and build a comparison page showing each original beside its result.
- Use Phota Enhance on the team portraits in this project, supplying only each person's relevant trained profile. Keep the originals and prepare a face-by-face review.
- Find compressed photographic assets in the project's gallery and try Phota Enhance on them. Show the results beside the sources before replacing anything.
- Use Phota Enhance on the noisy evening photos in assets/travel. Save the results separately and create a contact sheet for review.
- Use Phota Enhance on the blurry portrait examples in our image fixtures with their relevant trained profiles. Build a comparison view and flag faces that appear to have changed.

## How to set up Phota Enhance in VS Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to VS Code on the console's Agents & MCP page, or run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
```

2. **Sign in**: VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

### Use the Spiral skill

1. **Send VS Code 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 Phota 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/phota/enhance",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/0a8b911d/Abk8vStrvmSPlzUqI_NN3_image_043.png"
    }
  }'
```

Then paste one of the prompts above: VS Code finds Phota Enhance on Spiral, shows the price and runs it.

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

## Phota Enhance tools and prices

- [Phota Enhance](https://spiral.ai/tools/fal/fal-ai/phota/enhance) (fal): $0.169 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| profile_ids |  | — | List of profile IDs to use for the image enhancement. The profiles sent over will be used as candidates for identity preservation. |
| num_images | 1 to 4 | 1 | Number of images to generate. |
| output_format | jpeg, png | jpeg | The format of the generated image. |

## What can you do with Phota Enhance in VS Code?

Improve existing project photos with Phota Enhance and build comparisons into your review workflow. Have the agent retain the originals and flag portraits that need a closer identity check.

### Indoor event photos

Use Phota Enhance on dim event shots before choosing photos for a recap. Supply relevant profiles for recognizable attendees.

### Portraits for a profile update

Improve the lighting and color of an existing portrait. Include the person's trained profile and check the face against the original.

### Compressed photos shared in messages

Try Phota Enhance on a photo with visible compression artifacts before adding it to an album or post.

### Noisy evening snapshots

Process noisy photos from an evening outing, then compare each result with its source before selecting the keepers.

### Soft travel photos

Try automatic enhancement on blurry vacation shots. Review the results before including them in a travel album.

### Personal photo albums

Improve photos with lighting or color problems before assembling an album. Use only the relevant profiles for photos containing people.

## Overview

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

## Phota Enhance in other agents

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

## More VS Code guides

- [Perspective Change](https://spiral.ai/integrations/vscode/perspective-change)
- [Phota Image Editing](https://spiral.ai/integrations/vscode/phota-image-editing)
- [Parabolize](https://spiral.ai/integrations/vscode/parabolize)
- [Phota Text to Image](https://spiral.ai/integrations/vscode/phota-text-to-image)
- [PATINA Text to Material](https://spiral.ai/integrations/vscode/patina-text-to-material)
- [Photo Restoration](https://spiral.ai/integrations/vscode/photo-restoration)

## Questions about Phota Enhance in VS Code

**Can VS Code use Phota Enhance?**

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

**How much does Phota Enhance cost in VS Code?**

$0.169 per image. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.

**Do I need a fal account to use Phota Enhance in VS Code?**

No. Spiral runs Phota 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 Phota Enhance in VS Code?**

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

**Does VS Code wait while Phota Enhance runs?**

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

**What kinds of photo problems can Phota Enhance address?**

It is intended for photos with poor lighting, blur, noise, or compression artifacts. Use it to improve an existing shot whose photographic quality fell short.

**Do I need to write an enhancement prompt?**

No. Phota Enhance determines the corrections automatically, including lighting, color, and composition.

**Will Phota Enhance automatically recognize people I have profiles for?**

Only profiles supplied for the enhancement are considered. Include the relevant profiles when preserving a specific person's appearance matters.

**Can Phota Enhance struggle with faces?**

Yes. Blurry faces and faces hidden by other objects can make it difficult to identify the person. Compare the result with the original before keeping it.

**Should I include every profile when enhancing a photo?**

Include only the people relevant to that photo. Fewer candidates make it easier to match the right identities.

