# Qwen Image Edit

Edit and enhance images with Qwen Image Edit from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image
- Tool id: `fal` / `fal-ai/qwen-image-edit/image-to-image`
- Page: https://spiral.ai/tools/fal/fal-ai/qwen-image-edit/image-to-image

## Pricing

Up to $0.039 per run at the default inputs. $0.039 per unit of `num_images`.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | The prompt to generate the image with |
| `image_size` | JSON |  | — | The size of the generated image. |
| `num_inference_steps` | number (whole) | 2 to 50 | 30 | The number of inference steps to perform. |
| `seed` | number (whole) |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| `guidance_scale` | number | 0 to 20 | 4 | 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` | number (whole) | 1 to 4 | 1 | The number of images to generate. |
| `output_format` | one of | jpeg, png | png | The format of the generated image. |
| `image_url` (required) | URL or file |  | — | The URL of the image to edit. |
| `negative_prompt` | text |  |  | The negative prompt for the generation |
| `acceleration` | one of | none, regular, high | regular | Acceleration level for image generation. Options: 'none', 'regular'. Higher acceleration increases speed. 'regular' balances speed and quality. |
| `strength` | number | 0.01 to 1 | 0.94 | Strength of the image-to-image transformation. Lower values preserve more of the original image. |

## Example

```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-edit/image-to-image",
    "input": {
      "prompt": "Change bag to apple macbook",
      "image_url": "https://v3.fal.media/files/koala/oei_-iPIYFnhdB8SxojND_qwen-edit-res.png"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fqwen-image-edit%2Fimage-to-image

## Common questions

### Qwen Image Edit

**How much does Qwen Image Edit cost?**

Up to $0.039 per run at the default inputs. $0.039 per unit of `num_images`. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Qwen Image Edit through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/qwen-image-edit/image-to-image"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Qwen Image Edit?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Qwen Image Edit?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

