How to Use Phota Enhance in Gemini CLI
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.
Prompts to try with Phota Enhance in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
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 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 Phota 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/phota/enhance", "input": { "image_url": "https://v3b.fal.media/files/b/0a8b911d/Abk8vStrvmSPlzUqI_NN3_image_043.png" } }'
Then paste one of the prompts above: Gemini CLI finds Phota Enhance on Spiral, shows the price and runs it.
Phota Enhance providers and prices
Spiral runs Phota Enhance through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Phota Enhance works from your image URL. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of images | 1 to 4 | 1 | Number of images to generate. |
| Output format | jpeg or png | jpeg | The format of the generated image. |
Every API field of Phota Enhance is on its tool page: open its card above.
What can you do with Phota Enhance in Gemini CLI?
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.
More on Phota Enhance and Gemini CLI
Overview
Phota Enhance in other agents
Questions about Phota Enhance in Gemini CLI
Can Gemini CLI use Phota Enhance?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Phota Enhance like any built-in tool.
How much does Phota Enhance cost in Gemini CLI?
$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 Gemini CLI plan is separate.
Do I need a fal account to use Phota Enhance in Gemini CLI?
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 Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Phota Enhance runs?
Phota Enhance runs in the background. Gemini CLI 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.
Start using Phota 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


