[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Professional Photo](https://spiral.ai/integrations/codex/professional-photo)

# How to Use Professional Photo in Codex

Professional Photo turns casual photos into portraits with a studio photography look. Use it to draft a headshot for a work profile, speaker bio, or portfolio, then compare the result with your original.

|  |  |
| --- | --- |
| Model | Professional Photo |
| 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 Professional Photo in Codex

- Use Professional Photo on the portrait in public/images/about.jpg. Add a local about-page preview with the original and result side by side for review.
- Use Professional Photo on each individual speaker portrait in this project's assets. Build a review page showing each original beside its result and speaker name.
- Use Professional Photo on the consultant portrait referenced by the biography component. Create a preview using the result and preserve the original asset.
- Use Professional Photo on the author portrait in this project. Show the result in the existing biography layout and report its returned pixel dimensions.
- Use Professional Photo on the existing profile portrait twice, changing only the seed. Create a comparison page and record the settings beside each result.

## How to set up Professional Photo 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 Professional Photo**: 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-editing/professional-photo",
    "input": {
      "image_url": "https://v3.fal.media/files/zebra/hAjCkcyly4gsS9-cptD3Y_image%20(20).png"
    }
  }'
```

Then paste one of the prompts above: Codex finds Professional Photo on Spiral, shows the price and runs it.

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

## Professional Photo tools and prices

- [Image Editing Professional Photo](https://spiral.ai/tools/fal/fal-ai/image-editing/professional-photo) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| guidance_scale | 0 to 20 | 3.5 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |
| num_inference_steps | 1 to 50 | 30 | Number of inference steps for sampling. |
| safety_tolerance | 1, 2, 3, 4, 5, 6 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 6 being the most permissive. |
| output_format | jpeg, png | jpeg | The format of the generated image. |
| aspect_ratio | 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 | — | The aspect ratio of the generated image. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |

## What can you do with Professional Photo in Codex?

Turn existing project portraits into studio-style candidates for biography and profile pages. A coding agent can place the results in a preview and help you compare them with the originals.

### Work profile portrait

Turn a casual portrait into a candidate headshot for a work profile. Compare it with the original before publishing.

### Conference speaker biography

Prepare a studio-style portrait from an existing speaker photo for review alongside the event biography.

### Author biography

Draft an author portrait from a casual photo for a book page, newsletter biography, or publication profile.

### Personal portfolio

Prepare a portrait candidate for a portfolio's about page, then assess it beside the page's typography and imagery.

### Consultant introduction

Create a portrait draft from an existing photo for a consultant biography or proposal introduction.

### Team biography review

Process individual staff portraits for a team page and review each result with its original before selecting images.

## Overview

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

## Professional Photo in other agents

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

## More Codex guides

- [Product Photography](https://spiral.ai/integrations/codex/product-photography)
- [PuLID Flux](https://spiral.ai/integrations/codex/pulid-flux)
- [Product Holding](https://spiral.ai/integrations/codex/product-holding)
- [Qwen Image](https://spiral.ai/integrations/codex/qwen-image)
- [Post Processing Color Correction](https://spiral.ai/integrations/codex/post-processing-color-correction)
- [Qwen Image 2512](https://spiral.ai/integrations/codex/qwen-image-2512)

## Questions about Professional Photo in Codex

**Can Codex use Professional Photo?**

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

**How much does Professional Photo 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 Professional Photo in Codex?**

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

**How long does it take to set up Professional Photo in Codex?**

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

**Does Codex wait while Professional Photo runs?**

Professional Photo runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.

**What is Professional Photo best used for?**

Its stated purpose is turning casual photos into studio-style portraits. Suggested uses include work profiles, speaker biographies, and personal portfolios.

**What photographic treatment does Professional Photo aim for?**

The maker emphasizes studio portrait lighting and a professional photography style. Judge the result against the appearance you want for the intended placement.

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

Compare it directly with the original, especially the eyes, face shape, hairline, and skin texture. Keep only a result you recognize and would be comfortable publishing.

**How should I evaluate a portrait for print?**

Check the returned pixel dimensions against your intended print size. Inspect the face at full size before ordering prints.

**How should I compare different results?**

Use the same source photo and change one setting at a time. Record the seed and settings with each result so you can identify the treatment you prefer.

