Introduction
A practical guide to using theΒ Qwen Image Edit model in our Media Generator: options, costs, prompt tips, and best practices.
Qwen Image Edit is a fast, consistent image-editing model that requires a reference image. In our platform, it supports:
- Image editing β Modify existing images via prompt
- Consistent outputs β Strong fidelity to the reference
- Single reference β One input image per edit
- matchinputimage β Preserve input aspect ratio or choose a new one
Use it when you need to edit or transform an existing image with reliable, consistent results.
Where to Use Qwen Image Edit
| Location | How | |----------|-----| | Media Generator | Tools β Media Generator β Create Job β choose "Qwen Image Edit" β upload at least one reference image | | Image projects | Create a project, add reference images, and select Qwen Image Edit |
Requirements
- Reference image required β At least one input image is mandatory
- Reference defines the base content; the prompt describes the changes
Platform Options
Aspect ratio
| Option | Use case | |--------|----------| | matchinputimage | Keep input aspect ratio (default) | | 1:1 | Square output | | 16:9 | Landscape | | 9:16 | Portrait | | 4:3 | Standard | | 3:4 | Photo |
Default:
- match
input
- image
Output format
- PNG β Lossless
- JPG β Smaller file size
Default:
- PNG
Reference images
- Required β Minimum 1 image
- Single reference β One input image per generation (unlike Pruna, which supports multiple)
- Best for focused edits on a single source image
Costs (credits)
Qwen Image Edit uses flat per-image pricing:
| Item | USD | Credits | |------|-----|----------| | Per image | $0.03 | 0.08 |
\Credits computed with default billing config. Check the model selector in the UI for current rates.
Prompt guidelines
Do
- Describe what to change β e.g., "change background to white," "add autumn leaves"
- Be precise about edits β "replace the sky with clouds," "remove the text overlay"
- Use clear, action-oriented language
- Focus on one main edit per run for best consistency
Avoid
- Vague instructions ("make it better," "improve it")
- Asking for completely unrelated new content
- Multiple conflicting edit requests in one prompt
Good practices
- Use a clear reference image β Sharp, well-lit inputs give more consistent edits.
- Be specific in the prompt β Describe the exact change you want.
- Use matchinputimage when possible β Preserves composition and proportions.
- One main edit at a time β For complex changes, run multiple edits in sequence.
Limits and constraints
| Constraint | Value | |------------|-------| | Reference images | Required, 1 per generation | | Max images per request | 5 |
Qwen vs Pruna Image Edit
| Feature | Qwen Image Edit | Pruna Image Edit | |---------|-----------------|------------------| | Reference images | 1 required | 1β10 supported | | Cost per image | 0.08 credits | 0.03 credits | | Strengths | Consistency, reliability | Multiple refs, lower cost |
Choose Qwen when you want strong consistency on a single image; choose Pruna when you need to blend multiple references or keep costs lower.
Troubleshooting
| Issue | What to try | |-------|-------------| | Missing reference warning | Upload at least one reference image | | Unexpected or inconsistent edits | Simplify the prompt; focus on one main change | | Model not available | Confirm Replicate API token is configured |
