How to Use Professional Photo in Claude Code
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.
Prompts to try with Professional Photo in Claude Code
Copy an example into Claude Code, or ask in your own words.
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 Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Professional Photo
One request; the result comes back by polling or a webhook.
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: Claude Code finds Professional Photo on Spiral, shows the price and runs it.
Professional Photo providers and prices
Spiral runs Professional Photo through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Professional Photo works from your image URL. Ask Claude Code for any of these in your prompt.
| 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. |
| Number of inference steps | 1 to 50 | 30 | Number of inference steps for sampling. |
| Safety tolerance | 1 to 6 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 6 being the most permissive. |
| Output format | jpeg or 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 and 1 more | The aspect ratio of the generated image. | |
| Seed | a whole number | The same seed and the same prompt given to the same version of the model will output the same image every time. |
Every API field of Image Editing Professional Photo is on its tool page: open its card above.
What can you do with Professional Photo in Claude Code?
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.
More on Professional Photo and Claude Code
Overview
Professional Photo in other agents
Questions about Professional Photo in Claude Code
Can Claude Code use Professional Photo?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Professional Photo like any built-in tool.
How much does Professional Photo cost in Claude Code?
$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need a fal account to use Professional Photo in Claude Code?
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 Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Professional Photo runs?
Professional Photo runs in the background. Claude Code 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.
Start using Professional Photo in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md



