How to Use FLUX 3 Image Edit in Raycast
FLUX 3 Image Edit is for targeted photo changes and compositions built from up to ten references. Unlike FLUX 3 Text to Image, it starts from supplied images, so you can describe what to change and what to keep.
Prompts to try with FLUX 3 Image Edit in Raycast
Copy an example into Raycast, or ask in your own words.
Use FLUX 3 Image Edit on this product photo. Change only the red lid to forest green, keeping the bottle shape, label, and background.
Use FLUX 3 Image Edit with these two images. Image 1 supplies the kitchen; place the vase from image 2 on the counter beside the window.
Use FLUX 3 Image Edit to preview the jacket from image 2 on the person in image 1. Preserve the person's pose and the surrounding scene.
Use FLUX 3 Image Edit on this poster. Replace the top headline with "Saturday market", keeping its position and the illustration below.
Use FLUX 3 Image Edit to turn this landscape photo into a watercolor illustration. Preserve the mountain shapes, river path, and framing.
How to set up FLUX 3 Image Edit in Raycast
Pick the way that suits you. Each takes about two minutes.
Use the Raycast connector
- 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
- 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
- Send Raycast 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 FLUX 3 Image 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": "blackforestlabs/flux-3/edit-image", "input": { "prompt": "A red fox leaping over a stream in a pine forest, low-angle wildlife photograph.", "image_urls": [ "<image_urls>" ] } }'
Then paste one of the prompts above: Raycast finds FLUX 3 Image Edit on Spiral, shows the price and runs it.
FLUX 3 Image Edit providers and prices
Spiral runs FLUX 3 Image Edit through fal. Open a card for today's price, with every fee included.
Settings you can ask for
FLUX 3 Image Edit works from your prompt and image URLs. Ask Raycast for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Aspect ratio | auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4 and 7 more | auto | Output aspect ratio. Auto uses the first reference image when editing. |
| Resolution | 768sq, 1k, 1.5k, 2k, or 4k | 1k | Output resolution tier. 4k can take several minutes. |
| Enable prompt expansion | on or off | off | Expand the prompt while preserving its intent and reference roles. |
| Safety tolerance | 0 to 4 | 2 | Safety tolerance, from 0 (strictest) to 4. |
| Output format | jpeg or png | jpeg | The format of the generated image. |
Every API field of FLUX 3 Image Edit is on its tool page: open its card above.
What can you do with FLUX 3 Image Edit in Raycast?
Explore visual revisions from supplied photos and artwork with FLUX 3 Image Edit. Describe the change in ordinary language and identify the details you want preserved.
Product color previews
Recolor a product in an existing photo while asking to preserve its shape, label, and setting. Specify the target color with a hex code and check the match.
Product scene mockups
Combine a product reference with a setting reference to preview a new placement. Describe the product's position and how its lighting should fit the scene.
Outfit previews
Use a person photo and a garment reference to preview a clothing change. Name the pose and surrounding details you want to preserve.
Room furnishing concepts
Combine a room photo with furniture references to explore placement. State which object belongs where and which existing furnishings should stay.
Poster copy revisions
Revise words inside an existing poster. Quote the new copy and identify its location so the instruction targets the right text.
Object cleanup
Remove an unwanted object from an existing scene. Include its shadow or reflection in the removal request and inspect the surrounding area afterward.
Illustration restyling
Explore a different visual treatment for existing artwork. Describe the new medium and identify the shapes and composition to retain.
Packaging design previews
Combine a package photo with an artwork reference to preview a new surface design. Specify where the artwork belongs and which package details to preserve.
More on FLUX 3 Image Edit and Raycast
Overview
FLUX 3 Image Edit in other agents
Questions about FLUX 3 Image Edit in Raycast
Can Raycast use FLUX 3 Image Edit?
Yes. Add Spiral to Raycast as an MCP server, and Raycast can find and run FLUX 3 Image Edit like any built-in tool.
How much does FLUX 3 Image Edit cost in Raycast?
`resolution`: otherwise $0.0624, 1k (default) $0.1248, 1.5k $0.1872, 2k $0.312, 4k $1.0608 per megapixel. 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 FLUX 3 Image Edit in Raycast?
No. Spiral runs FLUX 3 Image 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 FLUX 3 Image Edit in Raycast?
About two minutes: install the server, then sign in to Spiral and approve.
Does Raycast wait while FLUX 3 Image Edit runs?
FLUX 3 Image Edit runs in the background. Raycast starts the run, checks on it and gives you the image when it's ready.
What is FLUX 3 Image Edit useful for?
Use it to change a specific detail, restyle an existing image, or combine references into a new composition. Start with an image that already contains the parts you want to keep.
How many reference images can I combine?
You can combine up to ten references. Give each one a clear job, such as the scene, product, garment, or visual style.
Will everything outside an edit stay unchanged?
Treat preservation as something to check. Even with targeted edits, nearby shadows, reflections, or lighting may change.
How large must reference images be?
Each reference must be at least 256 pixels on both sides. Oversized references are downscaled to at most four megapixels, so inspect small details in the result.
How do I change just one object?
Identify it by its appearance and location, then describe the replacement and the details to preserve. Bounding boxes can guide placement, but they do not create a hard clipping boundary.
Start using FLUX 3 Image Edit in Raycast
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Raycast:
set up https://spiral.ai/SKILL.md


