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

Windsurf · Image

How to Use FLUX.1 Dev LoRA in Windsurf

FLUX.1 Dev LoRA generates product concepts, portraits, and illustrations with trained styles or subjects. It adds custom LoRA adaptations to FLUX.1 Dev, making it useful when a written style description alone is too broad.

Prompts to try with FLUX.1 Dev LoRA in Windsurf

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

Read the homepage copy in this project, then use FLUX.1 Dev LoRA to generate a 1280 by 720 pixel illustration of its main idea. Use the configured style LoRA and its documented trigger phrase, with the subject on the right and open space on the left.

FLUX.1 Dev LoRAWindsurf
Try asking
  • Read the three newest article drafts in this project. Use FLUX.1 Dev LoRA to generate one editorial illustration per article with the configured style LoRA, distinct subjects, and a shared palette.

  • Use FLUX.1 Dev LoRA to compare the configured LoRA at strengths 0.5, 1.0, and 1.5. Keep the prompt, seed, dimensions, and other settings fixed: a ceramic teapot on a wooden table beside a rain-streaked window.

  • Read the game's environment brief in this repository. Use FLUX.1 Dev LoRA to generate separate concept images for the harbor, workshop, and forest settlement, applying the configured style LoRA and describing lighting and camera position for each.

  • Read the campaign brief in this project. Use FLUX.1 Dev LoRA with the configured product LoRA to generate three concepts of the trained item in a morning kitchen, a garden, and a studio. Flag visible product details that need review.

How to set up FLUX.1 Dev LoRA in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 FLUX.1 Dev LoRA

    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-lora",
        "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: Windsurf finds FLUX.1 Dev LoRA on Spiral, shows the price and runs it.

FLUX.1 Dev LoRA providers and prices

Spiral runs FLUX.1 Dev LoRA through fal. Open a card for today's price, with every fee included.

falImage

Settings you can ask for

FLUX.1 Dev LoRA works from your prompt. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Number of inference steps1 to 5028

The number of inference steps to perform.

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.

Guidance scale (CFG)0 to 353.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 images1 to 41

The number of images to generate. This is always set to 1 for streaming output.

Output formatjpeg or pngjpeg

The format of the generated image.

Accelerationnone or regularnone

Acceleration level for image generation. 'regular' balances speed and quality.

Every API field of FLUX.1 [dev] with LoRAs · Text to Image is on its tool page: open its card above.

What can you do with FLUX.1 Dev LoRA in Windsurf?

Create illustrations and campaign concepts that match your project's written brief. A coding agent can turn repository content into scene prompts and organize comparisons of LoRA strength or composition.

Editorial illustration series

Generate illustrations for related articles with the same trained style. Give each image a distinct subject and composition while retaining the visual treatment.

Product campaign concepts

Use a product LoRA to explore a trained item in seasonal settings or different lighting. Review the generated product details before selecting images.

Brand campaign imagery

Apply a brand style LoRA to campaign scenes, social images, and editorial artwork. Specify the palette, medium, and composition in each brief.

Character scene exploration

Use a character LoRA to explore poses, costumes, and settings for a story. Check each result against the intended character design.

Personalized portrait concepts

Generate portrait concepts with a trained person LoRA. Compare studio lighting, environmental settings, and framing before choosing a direction.

Game environment concepts

Explore locations such as workshops, harbors, and forest settlements with a chosen style LoRA. Use the results as visual references during preproduction.

Storyboard illustrations

Generate individual scene illustrations for a storyboard using a trained visual treatment. Specify the camera position and action separately for each shot.

Questions about FLUX.1 Dev LoRA in Windsurf

Can Windsurf use FLUX.1 Dev LoRA?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run FLUX.1 Dev LoRA like any built-in tool.

How much does FLUX.1 Dev LoRA cost in Windsurf?

$0.0455 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 Windsurf plan is separate.

Do I need a fal account to use FLUX.1 Dev LoRA in Windsurf?

No. Spiral runs FLUX.1 Dev LoRA 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 LoRA in Windsurf?

About two minutes: add the server, then sign in, then check it.

Does Windsurf wait while FLUX.1 Dev LoRA runs?

FLUX.1 Dev LoRA runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

What is FLUX.1 Dev LoRA useful for?

Use it for illustrations, product concepts, portraits, and campaign imagery that need a trained subject or visual treatment. A suitable LoRA gives you a more specific starting point than a style description alone.

How should I write a FLUX.1 Dev LoRA prompt?

Describe the subject, setting, composition, lighting, and medium. If your LoRA specifies a trigger phrase, include that phrase alongside the scene description.

How strong should the LoRA effect be?

The endpoint documentation suggests strengths typically between 0.5 and 1.5. Start at 1.0 and compare nearby values while keeping the scene and other settings fixed.

Can FLUX.1 Dev LoRA make widescreen images?

Yes. The documentation includes custom dimensions of 1280 by 720 pixels, a 16:9 image. Describe the composition for that shape, including where the subject and any open space should sit.

What should I check before using an image?

Check whether the image actually follows the brief. Black Forest Labs warns that FLUX.1 Dev can miss prompt requirements and is not intended to provide factual information, so review any image meant to explain a real object or process.

Get started

Start using FLUX.1 Dev LoRA in Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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