How to Use FLUX.1 Dev in opencode
FLUX.1 Dev turns written descriptions into images for editorial illustrations, product concepts, and scene studies. Black Forest Labs places its image quality below FLUX.1 Pro, with adjustable guidance and generation steps for refining results.
Prompts to try with FLUX.1 Dev in opencode
Copy an example into opencode, or ask in your own words.
Read the homepage copy and design tokens, then use FLUX.1 Dev to create a 1360 × 768 illustration of a paper boat crossing a calm lake at dawn. Match the project's colors, place the boat on the right, and leave open water on the left for the heading.
Use FLUX.1 Dev to create a 1024 × 1024 illustration for the project's empty search state: a small red squirrel examining an empty wooden basket, soft pencil shading, simple white background. Add the selected image to the component and write descriptive alt text.
Read the game's location notes and use FLUX.1 Dev to create a 1360 × 768 environment study of the harbor. Show the viewpoint from the pier, weathered wooden buildings, overcast light, and the architectural details described in the notes.
Use FLUX.1 Dev to create a 1024 × 1024 fictional product concept for the ceramic desk lamp described in the project brief. Show matte clay, a curved shade, and soft side lighting. Start at 30 steps with guidance 3.5 and save the result for design review.
Read the latest blog draft and use FLUX.1 Dev to create a 1360 × 768 editorial illustration of its main idea. Write a concrete scene description from the article, keep lettering out of the composition, and compare results at 30 and 50 steps.
How to set up FLUX.1 Dev 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.1 Dev
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-1/dev", "input": { "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture…" } }'
Then paste one of the prompts above: opencode finds FLUX.1 Dev on Spiral, shows the price and runs it.
FLUX.1 Dev providers and prices
Spiral runs FLUX.1 Dev through fal and fal. Open a card for today's price, with every fee included. Name one in your prompt, or let opencode pick.
$0.0325 per megapixel. image_size presets count as 1 MP; custom sizes round up to whole megapixels. Billed on num_images, default 1.
$0.0325 per megapixel. image_size presets count as 1 MP; custom sizes round up to whole megapixels. Billed on num_images, default 1.
Settings you can ask for
FLUX.1 Dev works from your prompt. Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of inference steps | 1 to 50 | 28 | The number of inference steps to perform. |
| Seed | a whole number | The same seed and the same prompt given to the same version of the model will output the same image every time. | |
| Guidance scale (CFG) | 1 to 20 | 3.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 images | 1 to 4 | 1 | The number of images to generate. |
| Output format | jpeg or png | jpeg | The format of the generated image. |
| Acceleration | none, regular, or high | none | The speed of the generation. The higher the speed, the faster the generation. |
Every API field of FLUX.1 [dev] · Text to Image is on its tool page: open its card above.
What can you do with FLUX.1 Dev in opencode?
Create original artwork that matches a project's written design brief. A coding agent can use project files to describe the scene, generate images with FLUX.1 Dev, and place the selected artwork in the interface.
Article illustrations
Turn an article's central idea into a visual metaphor, such as a tangled garden hose representing a complicated workflow.
Website artwork
Create an original scene from a written brief, specifying the subject's placement and leaving room for a heading.
Fictional product concepts
Explore a proposed object's shape, materials, and lighting before commissioning a prototype or arranging a photo shoot.
Game environment studies
Develop visual directions for a location by describing its architecture, weather, time of day, and camera position.
Cover artwork
Draft an illustrated book or podcast cover from a scene description, reserving space for lettering added during layout.
Interior design studies
Compare written room concepts with different furniture, materials, and light. Use the results to discuss appearance during planning.
Campaign visual exploration
Try several compositions for one campaign brief, keeping the subject and palette explicit while changing one creative choice at a time.
More on FLUX.1 Dev and opencode
Overview
FLUX.1 Dev in other agents
Questions about FLUX.1 Dev in opencode
Can opencode use FLUX.1 Dev?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run FLUX.1 Dev like any built-in tool.
How much does FLUX.1 Dev cost in opencode?
$0.0325 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. 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.1 Dev in opencode?
No. Spiral runs FLUX.1 Dev 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.1 Dev in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while FLUX.1 Dev runs?
FLUX.1 Dev runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.
What should I use FLUX.1 Dev for?
Use it to turn a written visual brief into an image. Practical starting points include article illustrations, fictional product concepts, scene studies, and website artwork.
What image resolution does FLUX.1 Dev support?
Black Forest Labs describes FLUX.1 as supporting different aspect ratios and resolutions from 0.1 to 2.0 megapixels. For a starting point, try a 1024 × 1024 square.
How should I write a FLUX.1 Dev prompt?
Write a short visual description in complete sentences. Name the subject, its action, the setting, lighting, and desired medium; describe what should appear using positive language.
How long can a FLUX.1 Dev prompt be?
Its T5 encoder supports up to 512 tokens. Treat that as a ceiling: start with a focused paragraph and add details only when they help define the image.
Should I increase guidance to improve FLUX.1 Dev results?
Start around 3.5 and inspect the result before increasing it. Higher guidance encourages closer adherence to the prompt, but it can reduce image quality.
Start using FLUX.1 Dev 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


