Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Alibaba Cloud / Wan 2.1

Wan 2.1 Image Editing

Instruction-guided image editing with ten operations including masked editing, style changes, expansion and super resolution.

availableClosed weightsImage editing
Official documentation (opens in a new tab)Reviewed 14 Oct 2026
36 of 44 specification fields collected
Text input limit800800
Maximum outputNot collectedAwaiting source review
Input billingSee ratesAlibaba Model Studio · Beijing
Output billingSee ratesPublished units and conditions below

Specifications

Provider-documented facts. “Not collected” means we have not verified that field yet, not that the feature is unsupported.

Context / input limit
Not collected
Maximum input tokens
Not collected
Maximum output
Not collected
Input modalities
Text, ImageSource for Input modalities (opens in a new tab)

API requires a prompt even though the card summary lists only Image.

Reasoning
Not collected
Streaming
Not collected
Knowledge cutoff
Not collected
Parameters
Not collected
Architecture
Not collected
Published availability regions
China (Beijing)Source for Published availability regions (opens in a new tab)
Prompt limits
800 characters; Chinese characters and letters count individually, and excess input is truncated.Source for Prompt limits (opens in a new tab)
Images per request
1–4; default 1Source for Images per request (opens in a new tab)
Request mode
Asynchronous HTTP submission with X-DashScope-Async: enable; poll task ID for results. SDK wrappers may wait synchronously for that async job.Source for Request mode (opens in a new tab)
Random seed range
0–2,147,483,647; omitted seed is random. Reusing a seed is not an exact-reproducibility guarantee.Source for Random seed range (opens in a new tab)
Visible watermark
Optional lower-right AI-generated watermark; false by default.Source for Visible watermark (opens in a new tab)
Output link expiry
Task IDs and generated image URLs expire after 24 hours. This does not establish input retention or training-use policy.Source for Output link expiry (opens in a new tab)
Usage metering
Per successfully generated output image. CNY and USD listings use different billing-market schedules, not a currency conversion.Source for Usage metering (opens in a new tab)
Free usage allowance
API: 500 images for 180 days after activation. Domestic central pricing: 500 images for 90 days from latest activation, release or approval. International-account schedule gives no Beijing free quota. Actual account entitlement unverified.Source for Free usage allowance (opens in a new tab)

International-account terms come from the separate international billing page, not a combined worldwide allowance.

Required request fields
input.prompt, input.function and input.base_image_url; mask_image_url required only for description_edit_with_mask.Source for Required request fields (opens in a new tab)
Image input limits
Base image and mask: 512–4,096 pixels per side; maximum 10 MB each.Source for Image input limits (opens in a new tab)
Input image formats
JPG, JPEG, PNG, BMP, TIFF, WEBPSource for Input image formats (opens in a new tab)
Image URL requirements
Public HTTP(S) URLs or Base64 for base image and mask; URLs must not contain Chinese characters. SDK local-file helpers do not make file paths an HTTP input format.Source for Image URL requirements (opens in a new tab)
Editing operations
stylization_all: global stylization, stylization_local: local stylization, description_edit: instruction editing, description_edit_with_mask: inpainting, remove_watermark: text watermark removal, expand: directional expansion, super_resolution: enhancement/upscaling, colorization: color restoration, doodle: sketch-guided generation, control_cartoon_feature: cartoon reference generationSource for Editing operations (opens in a new tab)
Global styles
French picture book, Gold foil artSource for Global styles (opens in a new tab)
Local styles
ice, cloud, chinese festive lantern, wooden, blue and white porcelain, fluffy, weaving, balloonSource for Local styles (opens in a new tab)

Style names used in prompts, not separate API model IDs.

Mask behavior
For inpainting, match the base-image dimensions. Pure white RGB [255,255,255] marks edits; pure black [0,0,0] marks preserved areas. Non-binary colors may not be recognized.Source for Mask behavior (opens in a new tab)
Generation controls
strength: 0–1, default 0.5, for stylization_all and description_edit. Directional expand scales: 1–2 each, default 1. super_resolution upscale_factor: integer 1–4, default 1 (enhance without enlargement). doodle is_sketch=false extracts a sketch first; true uses the supplied sketch.Source for Generation controls (opens in a new tab)
Generated assets
results: image URL or per-image error, usage.image_count: successful image outputs onlySource for Generated assets (opens in a new tab)
Output billing
Only successful image outputs are counted, including partial failures.Source for Output billing (opens in a new tab)

Access & pricing

Prices belong to an endpoint and billing tier. A provider listing does not guarantee access for every account or region.

Alibaba Model Studio · Beijing

Provider source (opens in a new tab)
API model ID
wanx2.1-imageedit
Access
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis. Asynchronous HTTP submission with X-DashScope-Async: enable; poll task ID for results. SDK wrappers may wait synchronously for that async job.
Regions
China (Beijing)
Published request quota
120 requests per minuteSource for Published request quota (opens in a new tab)
Task submission rate
2 submissions per secondSource for Task submission rate (opens in a new tab)
Concurrent requests
2 running tasksSource for Concurrent requests (opens in a new tab)
Request mode
Asynchronous HTTP submission with X-DashScope-Async: enable; poll task ID for results. SDK wrappers may wait synchronously for that async job.Source for Request mode (opens in a new tab)
Free usage allowance
API: 500 images for 180 days after activation. Domestic central pricing: 500 images for 90 days from latest activation, release or approval. International-account schedule gives no Beijing free quota. Actual account entitlement unverified.Source for Free usage allowance (opens in a new tab)

International-account terms come from the separate international billing page, not a combined worldwide allowance.

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 14 Oct 2026
CategoryUsageRateUnit
Domestic-account CNY listing · BeijingGenerated image1CN¥0.14image
International-account USD listing · BeijingGenerated image1$0.02007image

Rate conditions

  1. Published per-output-image tariff for the named billing market and deployment region; not a currency conversion. Free quota and eligibility vary by billing market.
Pricing source (opens in a new tab)Pricing source (opens in a new tab)

Data & enterprise terms

Result links expire after 24 hours. Input retention, training use and actual account entitlement remain unverified.

Caching

Caching can reuse earlier input processing. Availability, lifetime and billing depend on the endpoint. A cache hit still generates a new response.

01 / INITIAL INPUTProcess & retain

The system processes eligible input and retains reusable state.

02 / LATER REQUESTCheck available state

Reuse depends on matching input, session state and the cache policy.

03 / CACHE HITReuse & generate

Reusing state can reduce repeated work. Any charges follow the billing rules below.

What the measurements say

No benchmark observations have been added for this model. We do not turn a vendor description into a performance score.

Latency and throughput depend on the host, request size, reasoning settings and load. There is no measured speed or global usage figure in this record.

The record behind the model

Why it is included

Qualified classification inference: this separately named native image API is not an exact checkpoint in the reviewed official Wan-AI inventory. Public Wan2.1 T2V weights can also perform text-to-image generation, so task overlap alone neither proves equivalence nor proves private weights. The specific hosted Plus/Turbo/Flash/editing checkpoint lineage remains unverified; public video architecture and parameter counts are not copied.

Classification evidence (opens in a new tab)

Lifecycle dates

Beijing Model Studio release25 Mar 2025Source (opens in a new tab)

Sources reviewed