Image Generation

Qwen Image 2 Edit API

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

Prompting guide Compare image models Use cases

Img2Img

Editing

Credit Cost

0.5 credits

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-2-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-2-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 or composition prompt.	-
`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	Model variant to use. Use the rolling names (qwen-image-2.0, qwen-image-2.0-pro) for the latest behavior, or pin to a dated snapshot variant for reproducibility. `qwen-image-2.0qwen-image-2.0-2026-03-03qwen-image-2.0-proqwen-image-2.0-pro-2026-04-22qwen-image-2.0-pro-2026-03-03`	`qwen-image-2.0`
`size`	enum	Output image dimensions (widthheight). Optional — when omitted, the model matches the input image's aspect ratio. Total pixels 512² to 2048². When provided, the model rounds to the nearest multiple of 16. `102410247681152115276896012801280960`+16 more	-
`n`	integer	Number of images to generate (1-6). 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. Turn on to auto-enhance short prompts.	`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 his hair blue

1 credit

5.2s

Code Examples

Single image edit — copy and paste to get started

bash

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

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 0.5,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-08T16:43:32Z"
}

Completed Response