How to Use Luma Uni-1 Edit in Hermes
Luma Uni-1 Edit changes an existing image while retaining its composition, making it useful for background swaps and restyling. Unlike Luma Uni-1 Text to Image, it works on a source image you want to keep recognizable.
Prompts to try with Luma Uni-1 Edit in Hermes
Copy an example into Hermes, or ask in your own words.
When a new product photo is supplied, use Luma Uni-1 Edit to replace its background with a plain studio setting. Keep the product and original composition, then place the result in the review queue.
At the start of each month, use Luma Uni-1 Edit to revise the supplied event poster with the exact headline "OPEN STUDIO". Retain the artwork and layout, and request review of the lettering.
Every Monday at 9am: remove the background from the photo I attach with Luma Uni-1 Edit and give me a transparent PNG.
Use Luma Uni-1 Edit to clean up these product shots so they sit on pure white.
Edit this image with Luma Uni-1 Edit: keep the subject, swap the background for a sunlit studio.
How to set up Luma Uni-1 Edit in Hermes
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Hermes 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 Spiral's MCP server
- Add the server and sign in
Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.
hermes mcp add spiral \ --url https://api.spiral.ai/mcp \ --auth oauth \ --connect-timeout 300
- Check it
In a chat that was already open, run /reload-mcp.
hermes mcp list hermes mcp test spiral
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 Luma Uni-1 Edit
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": "luma/agent/uni-1/v1/edit", "input": { "prompt": "Replace the background with a sunset over the ocean.", "image_url": "https://storage.googleapis.com/falserverless/gallery/example_inputs_liuyifei.png" } }'
Then paste one of the prompts above: Hermes finds Luma Uni-1 Edit on Spiral, shows the price and runs it.
Luma Uni-1 Edit providers and prices
Spiral runs Luma Uni-1 Edit through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Luma Uni-1 Edit works from your prompt, image URL, and reference image URLs. Ask Hermes for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Style | auto or manga | auto | Visual style of the edited image. |
| Output format | png or jpeg | Encoding format of the edited image. |
Every API field of Luma Uni-1 Edit is on its tool page: open its card above.
What can you do with Luma Uni-1 Edit in Hermes?
Produce recurring visual drafts from a scheduled brief or a supplied image. An always-on agent can prepare campaign images, poster revisions, and storyboard drafts for review.
Product campaign images
Use product references to develop a new campaign composition, or revise an existing product shot. Keep the brief specific about the product, setting, and intended change.
Posters with short headlines
Create a poster or revise an existing layout with a brief headline in quotation marks. Keep the wording short enough to inspect easily before publication.
Storyboard development
Create a sequence of panels for a pitch, or revise an existing storyboard. Describe each panel separately and request consistent character appearance.
Website lead images
Develop a new image for the top of a website or refine an existing composition for the page. Max is useful when preparing the finished visual.
Book cover concepts
Explore a cover composition or revise a supplied cover image. Use a short quoted title and inspect the lettering before treating the image as finished.
Background replacement
Replace the setting around a photographed subject while retaining the original composition. Specify the background change and the subject details that should remain.
Restyling existing artwork
Apply a different visual treatment to an existing image while retaining its composition. Use references to guide the revision when a written description is insufficient.
More on Luma Uni-1 Edit and Hermes
Overview
Luma Uni-1 Edit in other agents
Questions about Luma Uni-1 Edit in Hermes
Can Hermes use Luma Uni-1 Edit?
Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Luma Uni-1 Edit like any built-in tool.
How much does Luma Uni-1 Edit cost in Hermes?
$0.0039 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.
Do I need a fal account to use Luma Uni-1 Edit in Hermes?
No. Spiral runs Luma Uni-1 Edit on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Luma Uni-1 Edit in Hermes?
About two minutes: add the server and sign in, then check it.
Does Hermes wait while Luma Uni-1 Edit runs?
Luma Uni-1 Edit runs in the background. Hermes starts the run, checks on it and gives you the image when it's ready.
What resolution does Luma Uni-1 produce?
Luma documents 2048-pixel, or 2K, output for Uni-1 and Uni-1 Max. Max improves output quality without increasing that documented resolution.
Can Luma Uni-1 put readable text in an image?
Yes. Put the exact wording in quotation marks and favor short headings or labels under 20 characters; long passages are less reliable.
Should I write Luma Uni-1 prompts in English?
English is the recommended choice. Luma says prompts in other languages produce less reliable results.
What does Max improve?
Uni-1 Max targets higher output quality with the same prompts and parameters. It is a useful choice when preparing a finished image or a detailed final revision.
Can Luma Uni-1 help with storyboards?
Yes. Describe the action in each panel and explicitly request the same character throughout; for revisions, identify the panels and details that should change.
Start using Luma Uni-1 Edit in Hermes
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Hermes:
set up https://spiral.ai/SKILL.md


