How to Use Luma Uni-1 Edit in Cline
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 Cline
Copy an example into Cline, or ask in your own words.
Use Luma Uni-1 Edit on the product photo in this project's assets. Replace the background with a quiet bookstore interior; keep the product, its position, and the original framing.
Use Luma Uni-1 Edit to revise the existing website lead image in this repository. Change the background to a plain studio setting while retaining the subject and composition.
Remove the background from the photo I attach with Luma Uni-1 Edit and give me a transparent PNG. Save the result in ./assets.
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 Cline
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
In the Cline panel, click the MCP Servers icon and open the Remote Servers tab. Enter:
cline mcp add spiral https://api.spiral.ai/mcp --transport http --yes
- Sign in
Open the Configure tab and click Authenticate on the Spiral server. Sign in to Spiral, pick the organization and click Authorize. No API key.
- Check it
Spiral shows as connected on the Configure tab. In the CLI:
cline config mcp
Use the Spiral skill
- Send Cline 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 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: Cline 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 Cline 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 Cline?
Turn a project's visual brief into images for a website, product campaign, or storyboard. A coding agent can use project assets to guide a new composition or revise an existing image.
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 Cline
Overview
Luma Uni-1 Edit in other agents
Questions about Luma Uni-1 Edit in Cline
Can Cline use Luma Uni-1 Edit?
Yes. Add Spiral to Cline as an MCP server, and Cline can find and run Luma Uni-1 Edit like any built-in tool.
How much does Luma Uni-1 Edit cost in Cline?
$0.0039 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cline plan is separate.
Do I need a fal account to use Luma Uni-1 Edit in Cline?
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 Cline?
About two minutes: add the server, then sign in, then check it.
Does Cline wait while Luma Uni-1 Edit runs?
Luma Uni-1 Edit runs in the background. Cline 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 Cline
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Cline:
set up https://spiral.ai/SKILL.md


