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

Raycast · Image

How to Use Background Change in Raycast

Background Change replaces a photo's setting with a scene you describe, such as a beach sunset or city street. Use it to explore new settings for existing product photos or portraits, then check the subject and lighting before publishing.

Prompts to try with Background Change in Raycast

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

Use Background Change on this product photo. Replace the setting with a pale stone terrace overlooking the sea, a distant horizon, and soft morning light from the left.

Background ChangeRaycast
Try asking
  • Use Background Change on this portrait. Request a quiet garden with distant green foliage and soft daylight; show the original beside the edit so I can review the person.

  • Use Background Change to make separate edits of this bag photo against a city street and a neutral studio backdrop. Keep the descriptions simple and show both results for comparison.

  • Use Background Change on this product photo with a beach sunset and palm trees in the distance. Ask for warm light from the right and a sandy surface beneath the product.

  • Use Background Change to repeat this edit with stronger adherence to the background description. Keep the photo and wording unchanged so I can compare the difference.

How to set up Background Change 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 Background Change

    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": "fal-ai/image-editing/background-change",
        "input": {
          "image_url": "https://v3.fal.media/files/zebra/hAjCkcyly4gsS9-cptD3Y_image%20(20).png"
        }
      }'

Then paste one of the prompts above: Raycast finds Background Change on Spiral, shows the price and runs it.

Background Change providers and prices

Spiral runs Background Change through fal. Open a card for today's price, with every fee included.

falImage
Image Editing Background Change
fal-ai/image-editing/background-change

Settings you can ask for

Background Change works from your image URL and background prompt. Ask Raycast for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Guidance scale0 to 203.5

The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.

Number of inference steps1 to 5030

Number of inference steps for sampling.

Safety tolerance1 to 62

The safety tolerance level for the generated image. 1 being the most strict and 6 being the most permissive.

Output formatjpeg or pngjpeg

The format of the generated image.

Aspect ratio21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 and 1 more

The aspect ratio of the generated image.

Seeda whole number

The same seed and the same prompt given to the same version of the model will output the same image every time.

Every API field of Image Editing Background Change is on its tool page: open its card above.

What can you do with Background Change in Raycast?

Explore new settings for an existing photo through a conversation. A chat agent can help turn a visual idea into a concrete background description and organize results for review.

Product setting concepts

Try an existing product photo against a kitchen counter, stone terrace, or studio backdrop. Compare the settings before choosing a direction for a campaign.

Portrait backdrop drafts

Explore an office, garden, or plain studio setting behind an existing portrait. Review facial details and the subject's outline against the original.

Seasonal campaign images

Request autumn foliage, a snowy courtyard, or a summer beach behind an existing subject. Keep the setting description specific to the campaign.

Ad creative comparisons

Use the same source photo to compare a city street, coastal scene, and neutral studio background. Select results based on subject accuracy and the campaign brief.

Website image concepts

Test a quieter background for an existing website photo. Request an uncluttered setting, then review the edited image in the intended page layout.

Coordinated catalog backdrops

Apply a shared background description to a set of product photos. Review each result for consistent scene direction, lighting, and product details.

Questions about Background Change in Raycast

Can Raycast use Background Change?

Yes. Add Spiral to Raycast as an MCP server, and Raycast can find and run Background Change like any built-in tool.

How much does Background Change cost in Raycast?

$0.052 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 Background Change in Raycast?

No. Spiral runs Background Change on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Background Change in Raycast?

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

Does Raycast wait while Background Change runs?

Background Change runs in the background. Raycast starts the run, checks on it and gives you the image when it's ready.

What is Background Change useful for?

It replaces the setting in an existing photo with a scene you describe. Try it for product scene concepts, portrait backdrops, or seasonal campaign drafts.

What should I write in a background prompt?

Describe the finished setting: location, surface, background details, and light. For example, try 'a pale stone terrace overlooking the sea, distant horizon, soft morning light from the left.'

How should I handle lighting and shadows?

Fal highlights lighting and shadows as part of background replacement. Describe light that suits the original photo, then inspect whether the subject and setting look consistent.

How can I get the result closer to my description?

Guidance controls prompt adherence. Try increasing it while keeping the photo and description unchanged, then compare the results.

What should I check before using an edited photo?

Compare the result with the original, especially faces, product labels, outlines, and small details. Treat exact subject preservation as an acceptance requirement and reject edits that change something important.

Get started

Start using Background Change 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