How to Use Luma Uni-1 Max Edit in VS Code
Luma Uni-1 Max Edit makes detailed revisions to an existing image while retaining its structure. Choose it over Luma Uni-1 Edit when higher output quality matters for the finished asset.
Prompts to try with Luma Uni-1 Max Edit in VS Code
Copy an example into VS Code, or ask in your own words.
Use Luma Uni-1 Max 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.
Use Luma Uni-1 Max 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.
Remove the background from the photo I attach with Luma Uni-1 Max Edit and give me a transparent PNG. Save the result in ./assets.
Use Luma Uni-1 Max Edit to clean up these product shots so they sit on pure white.
Edit this image with Luma Uni-1 Max Edit: keep the subject, swap the background for a sunlit studio.
How to set up Luma Uni-1 Max Edit in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - Sign in
VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.
Use the Spiral skill
- Send VS 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 Luma Uni-1 Max 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/max/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: VS Code finds Luma Uni-1 Max Edit on Spiral, shows the price and runs it.
Luma Uni-1 Max Edit providers and prices
Spiral runs Luma Uni-1 Max Edit through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Luma Uni-1 Max Edit works from your prompt, image URL, and reference image URLs. Ask VS Code 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 Max is on its tool page: open its card above.
What can you do with Luma Uni-1 Max Edit in VS Code?
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 Max Edit and VS Code
Overview
Luma Uni-1 Max Edit in other agents
Questions about Luma Uni-1 Max Edit in VS Code
Can VS Code use Luma Uni-1 Max Edit?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Luma Uni-1 Max Edit like any built-in tool.
How much does Luma Uni-1 Max Edit cost in VS Code?
$0.0039 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.
Do I need a fal account to use Luma Uni-1 Max Edit in VS Code?
No. Spiral runs Luma Uni-1 Max 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 Max Edit in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while Luma Uni-1 Max Edit runs?
Luma Uni-1 Max Edit runs in the background. VS Code 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 Max Edit in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


