[Integrations](https://spiral.ai/integrations) › [Factory Droid](https://spiral.ai/integrations/factory-droid) › [Qwen Image](https://spiral.ai/integrations/factory-droid/qwen-image)

# How to Use Qwen Image in Factory Droid

Use Qwen Image for posters, illustrated scenes, and artwork with English or Chinese lettering. Qwen Image 2512 improves human realism, natural textures, and text layout.

|  |  |
| --- | --- |
| Model | Qwen Image |
| Available through | fal |
| Category | Image |
| Price | $0.026 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Qwen Image in Factory Droid

- Read the event brief in this project and use Qwen Image to create a poster concept. Quote the exact event title in the image prompt, place it at the top, and keep the date on a separate line.
- Use Qwen Image to create an anime-style illustration for the project's reading page: a student reading beside a train window, countryside outside, with clear space above the character for the page heading.
- Generate a product photo with Qwen Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
- Make four logo concepts for a coffee brand called "Northline" with Qwen Image.
- Create a 16:9 hero image of a quiet mountain cabin at dusk with Qwen Image.

## How to set up Qwen Image in Factory Droid

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

### Use Spiral's MCP server

1. **Add the server**: Droid saves it to your user config, `~/.factory/mcp.json`, so it works in every project.

```bash
droid mcp add spiral https://api.spiral.ai/mcp --type http
```

2. **Sign in**: Start `droid`, type `/mcp`, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

3. **Check it**: Spiral shows as connected. needs authentication means the sign-in did not finish: run `/mcp` again.

```bash
droid mcp list
```

### Use the Spiral skill

1. **Send Factory Droid 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Qwen Image**: One request; the result comes back by polling or a webhook.

```bash
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/qwen-image",
    "input": {
      "prompt": "Mount Fuji with cherry blossoms in the foreground, clear sky, peaceful spring day, soft natural light, realistic landscape."
    }
  }'
```

Then paste one of the prompts above: Factory Droid finds Qwen Image on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/factory-droid

## Qwen Image tools and prices

- [Qwen Image · Text to Image](https://spiral.ai/tools/fal/fal-ai/qwen-image) (fal): $0.026 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

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | landscape_4_3 | The size of the generated image. |
| num_inference_steps | 2 to 250 | 30 | The number of inference steps to perform. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| guidance_scale | 0 to 20 | 2.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. |
| num_images | 1 to 4 | 1 | The number of images to generate. |
| output_format | jpeg, png | png | The format of the generated image. |

## What can you do with Qwen Image in Factory Droid?

Create visual assets that match a project's content and art direction. Turn repository briefs into image prompts with explicit composition, style, and lettering.

### Event poster concepts

Develop a poster with an exact headline, a short date line, and a clear visual theme. For Qwen Image Image to Image, supply an existing poster composition to rework.

### English and Chinese storefront artwork

Explore shop signs and window displays with specified English or Chinese wording. For Qwen Image Image to Image, start with a storefront picture.

### Illustrated cover studies

Explore an illustrated cover with a short title and a defined painting or anime style. For Qwen Image Image to Image, provide a starting cover or illustration.

### Campaign art direction

Explore photographic, painted, or minimalist treatments for a campaign concept. For Qwen Image Image to Image, provide an existing campaign image to restyle.

### Fictional portrait concepts

Create portraits from a written description of appearance, expression, clothing, and setting. Qwen Image 2512 improves human realism compared with Qwen Image.

### Nature illustrations

Create landscape and wildlife scenes from a written brief. Qwen Image 2512 gives natural textures particular attention.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Factory Droid guides](https://spiral.ai/integrations/factory-droid)

## Qwen Image in other agents

- [Amp](https://spiral.ai/integrations/amp/qwen-image)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/qwen-image)
- [Claude](https://spiral.ai/integrations/claude-desktop/qwen-image)
- [Claude Code](https://spiral.ai/integrations/claude-code/qwen-image)
- [Cline](https://spiral.ai/integrations/cline/qwen-image)
- [Codex](https://spiral.ai/integrations/codex/qwen-image)
- [Cursor](https://spiral.ai/integrations/cursor/qwen-image)
- [Devin](https://spiral.ai/integrations/devin/qwen-image)
- [dots](https://spiral.ai/integrations/dots/qwen-image)
- [Gemini](https://spiral.ai/integrations/gemini/qwen-image)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/qwen-image)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/qwen-image)
- [goose](https://spiral.ai/integrations/goose/qwen-image)
- [Grok](https://spiral.ai/integrations/grok/qwen-image)
- [Grok Build](https://spiral.ai/integrations/grok-build/qwen-image)
- [Hermes](https://spiral.ai/integrations/hermes/qwen-image)
- [Instinct](https://spiral.ai/integrations/instinct/qwen-image)
- [Manus](https://spiral.ai/integrations/manus/qwen-image)
- [Muse](https://spiral.ai/integrations/muse/qwen-image)
- [Muse Code](https://spiral.ai/integrations/muse-code/qwen-image)
- [n8n](https://spiral.ai/integrations/n8n/qwen-image)
- [Notion](https://spiral.ai/integrations/notion/qwen-image)
- [OpenClaw](https://spiral.ai/integrations/openclaw/qwen-image)
- [opencode](https://spiral.ai/integrations/opencode/qwen-image)
- [Perplexity](https://spiral.ai/integrations/perplexity/qwen-image)
- [Raycast](https://spiral.ai/integrations/raycast/qwen-image)
- [VS Code](https://spiral.ai/integrations/vscode/qwen-image)
- [Windsurf](https://spiral.ai/integrations/windsurf/qwen-image)
- [Zapier](https://spiral.ai/integrations/zapier/qwen-image)

## More Factory Droid guides

- [PuLID Flux](https://spiral.ai/integrations/factory-droid/pulid-flux)
- [Qwen Image 2512](https://spiral.ai/integrations/factory-droid/qwen-image-2512)
- [Professional Photo](https://spiral.ai/integrations/factory-droid/professional-photo)
- [Qwen Image 2512 LoRA](https://spiral.ai/integrations/factory-droid/qwen-image-2512-lora)
- [Product Photography](https://spiral.ai/integrations/factory-droid/product-photography)
- [Qwen Image 3 Edit](https://spiral.ai/integrations/factory-droid/qwen-image-3-edit)

## Questions about Qwen Image in Factory Droid

**Can Factory Droid use Qwen Image?**

Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run Qwen Image like any built-in tool.

**How much does Qwen Image cost in Factory Droid?**

$0.026 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 Factory Droid plan is separate.

**Do I need a fal account to use Qwen Image in Factory Droid?**

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

**How long does it take to set up Qwen Image in Factory Droid?**

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

**Does Factory Droid wait while Qwen Image runs?**

Qwen Image runs in the background. Factory Droid starts the run, checks on it and gives you the image when it's ready.

**What is Qwen Image especially useful for?**

Artwork that combines a scene with readable lettering, such as event posters, storefront concepts, and illustrated covers. English and Chinese text are documented strengths.

**How should I prompt lettering?**

Put the exact wording in double quotation marks. Specify where it belongs, its font style and color, and whether it appears on paper, a sign, clothing, or another surface.

**Which languages should I start with?**

English and Chinese are the best-documented starting points for visible text. Keep names and slogans in their original wording when writing your prompt.

**Can Qwen Image make illustrations as well as photographs?**

Yes. Qwen documents photographic scenes, impressionist painting, anime, and minimalist design, so name the intended medium explicitly.

**What makes a useful visual prompt?**

Describe the subject, its position, the artistic style, and the composition. For text-heavy artwork, assign each phrase a clear location instead of asking for a poster with unspecified writing.

