Spiral gives your agent every tool with one account. Browse the tools →

Raycast · Image

How to Use Luma Uni-1 Edit in Raycast

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 Raycast

Copy an example into Raycast, or ask in your own words.

Use Luma Uni-1 Edit to replace the background in the attached portrait with a quiet bookstore. Keep the person's face, clothing, pose, and original framing.

Luma Uni-1 EditRaycast
Try asking
  • Use Luma Uni-1 Edit to revise the attached poster. Change only the headline to "OPEN STUDIO" and retain the illustration and overall composition.

  • 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 Raycast

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

Use the Raycast connector

  1. Install the server

    In Raycast run Install MCP Server. Name it Spiral, set Transport to HTTP, paste this URL and keep OAuth Type on Dynamic:

    https://api.spiral.ai/mcp
  2. Sign in to Spiral and approve

    Spiral opens in your browser: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Raycast never sees it, and you can remove it under Settings › Connected apps in the console.

Use the Spiral skill

  1. Send Raycast 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 the Spiral CLI

  1. 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

  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.

    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: Raycast 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.

falImage
Luma Uni-1 Edit
luma/agent/uni-1/v1/edit

Settings you can ask for

Luma Uni-1 Edit works from your prompt, image URL, and reference image URLs. Ask Raycast for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Styleauto or mangaauto

Visual style of the edited image.

Output formatpng 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 Raycast?

Turn a conversation about an image into a concrete poster, campaign visual, or storyboard. A chat app can help describe a new composition or make a focused revision to an image you provide.

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.

Questions about Luma Uni-1 Edit in Raycast

Can Raycast use Luma Uni-1 Edit?

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

How much does Luma Uni-1 Edit cost in Raycast?

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

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

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 Raycast?

About two minutes: install the server, then sign in to Spiral and approve.

Does Raycast wait while Luma Uni-1 Edit runs?

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

Get started

Start using Luma Uni-1 Edit in Raycast

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Raycast:

Set up Raycast

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options