How to Use Portrait Enhance in Gemini CLI
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.
Prompts to try with Portrait Enhance in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Portrait Enhance on the employee portraits in public/team. Save separate review copies and build a local before-and-after gallery.
Use Portrait Enhance on the author photo in this project. Preview the result in the article biography component at its current display size.
Use Portrait Enhance on the conference speaker portraits. Create a review page showing each original beside its result and returned pixel dimensions.
Use Portrait Enhance on the founder headshot. Show the result in our About page and flag visible changes to facial details.
Use Portrait Enhance on the interview portraits in assets/interviews. Save the results separately and prepare a contact sheet for editorial review.
How to set up Portrait Enhance in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 Portrait Enhance
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-apps-v2/portrait-enhance", "input": { "image_url": "https://v3b.fal.media/files/b/monkey/VszUszGx2uzReqFvQzF26.jpg" } }'
Then paste one of the prompts above: Gemini CLI finds Portrait Enhance on Spiral, shows the price and runs it.
Portrait Enhance providers and prices
Spiral runs Portrait Enhance through fal. Open a card for today's price, with every fee included.
What can you do with Portrait Enhance in Gemini CLI?
Prepare portrait assets for team pages, author biographies, and speaker profiles with Portrait Enhance. Have the coding agent save review copies and compare them in the project's actual layouts.
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.
More on Portrait Enhance and Gemini CLI
Overview
Portrait Enhance in other agents
Questions about Portrait Enhance in Gemini CLI
Can Gemini CLI use Portrait Enhance?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Portrait Enhance like any built-in tool.
How much does Portrait Enhance cost in Gemini CLI?
$0.52 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need a fal account to use Portrait Enhance in Gemini CLI?
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 Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Portrait Enhance runs?
Portrait Enhance runs in the background. Gemini CLI 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.
Start using Portrait Enhance in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


