Wan 2.1 — Create task

POST

/services/aigc/image2image/image-synthesis

# China North 2 (Beijing). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl --location 'https://cn-beijing.maas.qwencloudapi.com/api/v1/services/aigc/image2image/image-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wanx2.1-imageedit",
  "input": {
    "function": "stylization_all",
    "prompt": "Convert to a French picture-book style.",
    "base_image_url": "http://wanx.alicdn.com/material/20250318/stylization_all_1.jpeg"
  },
  "parameters": {
    "n": 1
  }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

Supported regions: China North 2 (Beijing) only. Use an API key created in that region and https://cn-beijing.maas.qwencloudapi.com.
Get an API key and set it as an environment variable first. To use an SDK, install the SDK.

The model supports 10 image editing functions:

Function	`function` value	Description
Whole-image stylization	`stylization_all`	Apply a style to the whole image
Local stylization	`stylization_local`	Apply a style to part of the image
Instruction editing	`description_edit`	Edit the image from a text description
Mask editing	`description_edit_with_mask`	Precise editing within a mask
Watermark removal	`remove_watermark`	Remove a watermark from the image
Outpainting	`expand`	Extend the canvas in four directions
Super resolution	`super_resolution`	Increase image resolution
Colorization	`colorization`	Add color to a black-and-white image
Doodle-to-image	`doodle`	Generate an image from a doodle
Cartoon feature control	`control_cartoon_feature`	Cartoonize while preserving the subject's features

Authorizations

string

header

required

QwenCloud API key. See Get an API key.

Header Parameters

enum<string>

default"enable"

required

Enable asynchronous processing. Must be set to enable. HTTP requests support only asynchronous calls; omitting this header returns an error.

Available options:enable

Body

application/json

enum<string>

required

Model name.

Available options:wanx2.1-imageedit

Example:wanx2.1-imageedit

object

required

Input data for image editing.

Show child attributes

enum<string>

required

Editing function type.

| Value | Function | |---|---| | stylization_all | Whole-image stylization | | stylization_local | Local stylization | | description_edit | Instruction editing | | description_edit_with_mask | Mask editing (requires mask_image_url) | | remove_watermark | Watermark removal | | expand | Outpainting | | super_resolution | Super resolution | | colorization | Colorization | | doodle | Doodle-to-image | | control_cartoon_feature | Cartoon feature control |

Available options:stylization_all,stylization_local,description_edit,description_edit_with_mask,remove_watermark,expand,super_resolution,colorization,doodle,control_cartoon_feature

Example:description_edit_with_mask

string

required

Text prompt describing the edit. Chinese and English are supported. Maximum length: 800 characters; longer input is truncated.

Example:A ceramic rabbit holding a small ceramic flower.

Required range:length <= 800

string

required

URL or Base64-encoded string of the source image.

Image requirements:

Supported formats: JPG, JPEG, PNG, BMP, TIFF, WEBP
Resolution: width and height must each be between 512 and 4096 pixels
Maximum file size: 10 MB

Supported input formats:

Public URL: HTTP and HTTPS
Base64: data:{MIME_type};base64,{base64_data}

Example:http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3.jpeg

string

URL or Base64-encoded string of the mask image. Required only when function is description_edit_with_mask. White areas are edited and black areas are preserved. The mask must have the same dimensions as the source image.

Example:http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3_mask.png

object

Processing options such as output count, random seed, and watermark. Different editing functions support different parameters.

Show child attributes

integer

default1

Number of images to generate. Value range: 1-4. Default: 1.

Example:1

Required range:1 <= x <= 4

integer

Random seed. Value range: [0, 2147483647]. If unset, the algorithm generates one. A fixed seed makes results reproducible, but inherent randomness means the same seed does not guarantee identical output.

Required range:0 <= x <= 2147483647

boolean

defaultfalse

Whether to add the fixed "AI generated" watermark to the bottom-right corner. Default: false.

Example:false

number

default0.5

Edit strength. Applies only to stylization_all and description_edit. Value range: 0.0-1.0. Default: 0.5. Higher values produce images that differ more from the source.

Example:0.5

Required range:0 <= x <= 1

number

default1

Upward expansion ratio. Applies only to expand. Value range: 1.0-2.0. Default: 1.0. For example, 1.5 expands the image upward by 50% of its height.

Example:1.5

Required range:1 <= x <= 2

number

default1

Downward expansion ratio. Applies only to expand. Value range: 1.0-2.0. Default: 1.0.

Example:1.5

Required range:1 <= x <= 2

number

default1

Leftward expansion ratio. Applies only to expand. Value range: 1.0-2.0. Default: 1.0.

Example:1.5

Required range:1 <= x <= 2

number

default1

Rightward expansion ratio. Applies only to expand. Value range: 1.0-2.0. Default: 1.0.

Example:1.5

Required range:1 <= x <= 2

integer

default1

Super-resolution upscale factor. Applies only to super_resolution. Value range: 1-4. Default: 1.

Example:2

Required range:1 <= x <= 4

boolean

defaultfalse

Whether the input is a line drawing. Applies only to doodle. Default: false. When false, the model extracts line art from the input image first; when true, the input image is used as line art directly.

Example:false

Response

200-application/json

object

Show child attributes

string

Task ID. Use it to query the task status within 24 hours.

enum<string>

Task status.

Available options:PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

Unique request identifier for troubleshooting.