Image Generation

Qwen Image Edit API

Alibaba DashScope Qwen Image edit — supply 1-3 reference images plus an edit instruction. Plus and Max model variants. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare image models Use cases

Img2Img

Editing

Credit Cost

1 credit

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/qwen-image-edit/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/qwen-image-edit.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Edit instruction.	-
`image` required	array	One to three input images. Accepts a single URL string or an array of URLs. Image order defines the array sequence; the output aspect ratio matches the last image when size is omitted. Accepted formats: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF; max 10 MB each. min items: 1 \| max items: 3	-
`model`	enum	Edit-model variant. Use the rolling names (qwen-image-edit-plus, qwen-image-edit-max) for the latest behavior, or pin to a dated snapshot for reproducibility. The legacy `qwen-image-edit` fixes n=1 and ignores size / prompt_extend. `qwen-image-edit-plusqwen-image-edit-plus-2025-12-15qwen-image-edit-plus-2025-10-30qwen-image-edit-maxqwen-image-edit-max-2026-01-16`+1 more	`qwen-image-edit-plus`
`aspect_ratio`	enum	Output aspect ratio. Omit to match the input image's aspect ratio. Used to derive `size` when an explicit `size` value is not supplied. `1:116:99:164:33:4`+1 more	-
`size`	enum	Output dimensions (widthheight). Optional — when omitted, the model matches the input image's aspect ratio. Width / height each between 512 and 2048; the model rounds to the nearest multiple of 16. `10241024153615367681152102415361152768`+11 more	-
`n`	integer	Number of images to generate (1-6 on edit-plus / edit-max; fixed at 1 on qwen-image-edit). min: 1 \| max: 6	`1`
`negative_prompt`	string	What to avoid in the output (max 500 characters).	-
`prompt_extend`	boolean	Server-side LLM prompt rewriting. Off by default so your exact edit instruction is followed. Not supported on qwen-image-edit (legacy).	`false`
`watermark`	boolean	Adds a "Qwen-Image" watermark to the bottom-right corner.	`false`
`seed`	integer	Random seed (0–2147483647). Same seed + same inputs yields similar (not identical) outputs. Omit for random. min: 0 \| max: 2147483647	-

Use saved characters (@Name)

This model takes no reference images, so @Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.

Example Outputs

Real outputs generated by this model

View Details

make the wizard green

1 credit

7.9s

Code Examples

Single image edit — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/qwen-image-edit/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "make it watercolor",
    "image": "https://..."
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-10T02:50:24Z"
}

Completed Response