[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [Luma Uni-1 Edit](https://spiral.ai/integrations/instinct/luma-uni-1-edit)

# How to Use Luma Uni-1 Edit in Instinct

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.

|  |  |
| --- | --- |
| Model | Luma Uni-1 Edit |
| Available through | fal |
| Category | Image |
| Price | $0.0039 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Luma Uni-1 Edit in Instinct

- 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 Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **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

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Luma Uni-1 Edit**: One request; the result comes back by polling or a webhook.

```bash
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: Instinct finds Luma Uni-1 Edit on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## Luma Uni-1 Edit tools and prices

- [Luma Uni-1 Edit](https://spiral.ai/tools/fal/luma/agent/uni-1/v1/edit) (fal): $0.0039 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| style | auto, manga | auto | Visual style of the edited image. |
| output_format | png, jpeg | — | Encoding format of the edited image. |
| reference_image_urls |  | — | Optional list of reference image URLs used to guide the edit. |

## What can you do with Luma Uni-1 Edit in Instinct?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## Luma Uni-1 Edit in other agents

- [Amp](https://spiral.ai/integrations/amp/luma-uni-1-edit)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/luma-uni-1-edit)
- [Claude](https://spiral.ai/integrations/claude-desktop/luma-uni-1-edit)
- [Claude Code](https://spiral.ai/integrations/claude-code/luma-uni-1-edit)
- [Cline](https://spiral.ai/integrations/cline/luma-uni-1-edit)
- [Codex](https://spiral.ai/integrations/codex/luma-uni-1-edit)
- [Cursor](https://spiral.ai/integrations/cursor/luma-uni-1-edit)
- [Devin](https://spiral.ai/integrations/devin/luma-uni-1-edit)
- [dots](https://spiral.ai/integrations/dots/luma-uni-1-edit)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/luma-uni-1-edit)
- [Gemini](https://spiral.ai/integrations/gemini/luma-uni-1-edit)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/luma-uni-1-edit)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/luma-uni-1-edit)
- [goose](https://spiral.ai/integrations/goose/luma-uni-1-edit)
- [Grok](https://spiral.ai/integrations/grok/luma-uni-1-edit)
- [Grok Build](https://spiral.ai/integrations/grok-build/luma-uni-1-edit)
- [Hermes](https://spiral.ai/integrations/hermes/luma-uni-1-edit)
- [Manus](https://spiral.ai/integrations/manus/luma-uni-1-edit)
- [Muse](https://spiral.ai/integrations/muse/luma-uni-1-edit)
- [Muse Code](https://spiral.ai/integrations/muse-code/luma-uni-1-edit)
- [n8n](https://spiral.ai/integrations/n8n/luma-uni-1-edit)
- [Notion](https://spiral.ai/integrations/notion/luma-uni-1-edit)
- [OpenClaw](https://spiral.ai/integrations/openclaw/luma-uni-1-edit)
- [opencode](https://spiral.ai/integrations/opencode/luma-uni-1-edit)
- [Perplexity](https://spiral.ai/integrations/perplexity/luma-uni-1-edit)
- [Raycast](https://spiral.ai/integrations/raycast/luma-uni-1-edit)
- [VS Code](https://spiral.ai/integrations/vscode/luma-uni-1-edit)
- [Windsurf](https://spiral.ai/integrations/windsurf/luma-uni-1-edit)
- [Zapier](https://spiral.ai/integrations/zapier/luma-uni-1-edit)

## More Instinct guides

- [Krea 3 Text to Image](https://spiral.ai/integrations/instinct/krea-3-text-to-image)
- [Luma Uni-1 Max](https://spiral.ai/integrations/instinct/luma-uni-1-max)
- [Krea 3 Edit](https://spiral.ai/integrations/instinct/krea-3-edit)
- [Luma Uni-1 Max Edit](https://spiral.ai/integrations/instinct/luma-uni-1-max-edit)
- [Krea 2 Turbo Style](https://spiral.ai/integrations/instinct/krea-2-turbo-style)
- [Luma Uni-1 Text to Image](https://spiral.ai/integrations/instinct/luma-uni-1-text-to-image)

## Questions about Luma Uni-1 Edit in Instinct

**Can Instinct use Luma Uni-1 Edit?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run Luma Uni-1 Edit like any built-in tool.

**How much does Luma Uni-1 Edit cost in Instinct?**

$0.0039 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need a fal account to use Luma Uni-1 Edit in Instinct?**

You need no fal account. Instinct uses one Spiral API key for every tool, and Spiral runs Luma Uni-1 Edit on its own fal account.

**How long does it take to set up Luma Uni-1 Edit in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while Luma Uni-1 Edit runs?**

Luma Uni-1 Edit runs in the background. Instinct 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.

