How to Use FLUX.2 Turbo Edit in opencode
Use FLUX.2 Turbo Edit for image revisions with the eight-step distilled model. Unlike FLUX.2 Turbo, it works from existing imagery to change scenes, objects, or colors.
Prompts to try with FLUX.2 Turbo Edit in opencode
Copy an example into opencode, or ask in your own words.
Use FLUX.2 Turbo Edit to revise the project's onboarding illustration. Change the setting to a bright home office while preserving the person's pose, clothing, and position. Keep the result at 1024 × 1024.
Use FLUX.2 Turbo Edit on the product photograph in the project's assets. Place the product on a dark stone counter with soft window light from the right. Preserve its shape, label wording, and camera angle. Return a 1536 × 1024 image.
Remove the background from the photo I attach with FLUX.2 Turbo Edit and give me a transparent PNG. Save the result in ./assets.
Use FLUX.2 Turbo Edit to clean up these product shots so they sit on pure white.
Edit this image with FLUX.2 Turbo Edit: keep the subject, swap the background for a sunlit studio.
How to set up FLUX.2 Turbo Edit in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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.2 Turbo 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": "fal-ai/flux-2/turbo/edit", "input": { "prompt": "Change the weather to winter", "image_urls": [ "<image_urls>" ] } }'
Then paste one of the prompts above: opencode finds FLUX.2 Turbo Edit on Spiral, shows the price and runs it.
FLUX.2 Turbo Edit providers and prices
Spiral runs FLUX.2 Turbo Edit through fal. Open a card for today's price, with every fee included.
Up to $0.052 per run at the default inputs. $0.0416 per unit of num_images. Each item in image_urls adds $0.0104.
Settings you can ask for
FLUX.2 Turbo Edit works from your prompt and image URLs. Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Guidance scale | 0 to 20 | 2.5 | 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. |
| Seed | a whole number | The seed to use for the generation. If not provided, a random seed will be used. | |
| Number of images | 1 to 4 | 1 | The number of images to generate. |
| Enable prompt expansion | on or off | off | If set to true, the prompt will be expanded for better results. |
| Output format | jpeg, png, or webp | png | The format of the generated image. |
Every API field of FLUX 2 Turbo Edit · Image Editing is on its tool page: open its card above.
What can you do with FLUX.2 Turbo Edit in opencode?
Create product imagery and visual design concepts alongside the project you are building. Have the agent turn project requirements into concrete image briefs with explicit composition, colors, and text.
Product background changes
Start with a product image and request a new setting. Describe the product details to preserve and the lighting needed in the replacement scene.
Color studies from existing images
Recolor a garment, package, or piece of furniture in a supplied image. Name the object and provide its target hex color while asking to preserve its texture.
Illustrated treatments of photographs
Transform a supplied photograph into a specified illustration style. State which subjects, poses, and spatial relationships should remain recognizable.
Reference-based compositions
Combine a subject from one reference with an object or setting from another. Explain what each image contributes and how the elements should fit together.
More on FLUX.2 Turbo Edit and opencode
Overview
FLUX.2 Turbo Edit in other agents
Questions about FLUX.2 Turbo Edit in opencode
Can opencode use FLUX.2 Turbo Edit?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run FLUX.2 Turbo Edit like any built-in tool.
How much does FLUX.2 Turbo Edit cost in opencode?
Up to $0.052 per run at the default inputs. $0.0416 per unit of `num_images`. Each item in `image_urls` adds $0.0104. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need a fal account to use FLUX.2 Turbo Edit in opencode?
No. Spiral runs FLUX.2 Turbo 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.2 Turbo Edit in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while FLUX.2 Turbo Edit runs?
FLUX.2 Turbo Edit runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.
What is FLUX.2 good at?
FLUX.2 is useful for realistic product imagery, editorial scenes, and designs that include text. Specify the materials, lighting, composition, and exact wording you want.
How large can FLUX.2 images be?
These FLUX.2 tools support dimensions from 512 to 2048 pixels per side. A square image can reach 2048 × 2048 pixels, roughly four megapixels.
How should I write a FLUX.2 prompt?
Describe the subject, action, visual style, and setting. Use concrete details such as brushed steel, side lighting, or an overhead view.
Does FLUX.2 support negative prompts?
No. Describe the desired result positively: ask for an empty street or sharp focus instead of listing things to exclude.
How do I get readable text in FLUX.2 images?
Put the exact wording in quotation marks and describe its position and appearance. Black Forest Labs warns that text-bearing objects can produce gibberish when you leave their wording unspecified.
Start using FLUX.2 Turbo Edit in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


