Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Alibaba Cloud / Virtual Model

Wanx Virtual Model

Product-photo editing that replaces a person and background while preserving the product and pose. Version 1 accepts real-person photos and optional preset identities.

restrictedClosed weightsImage editing
Official documentation (opens in a new tab)Reviewed 14 Oct 2026
31 of 39 specification fields collected
Output resolutionShort side 512 pixels, Short side 1,024 pixelsSee specification notes below
Text input limit100 characters for prompt and another 100 for face_prompt, separately.See specification notes below
Input billingSee billing notesAlibaba Model Studio · Beijing · trial only
Output billingSee billing notesAccess and billing notes 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)

The detailed API requires text prompts in addition to images; the summary card 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)
Request mode
Async task submission with X-DashScope-Async: enable; query GET /api/v1/tasks/{task_id}. Async jobs are not Batch API support.Source for Request mode (opens in a new tab)
Published price
Trial only; paid usage unavailable.Source for Published price (opens in a new tab)
Usage metering
500 output images per model within the published trial. Requests stop when the quota is exhausted.Source for Usage metering (opens in a new tab)
Free usage allowance
500 images; 90-day validity from the latest service activation, model release or application approval. Actual account entitlement is not verified.Source for Free usage allowance (opens in a new tab)
Images per request
1–4 outputs; default 1Source for Images per request (opens in a new tab)
Required request fields
base_image_url, mask_image_url, prompt, face_prompt and parameters.short_side_size.Source for Required request fields (opens in a new tab)
Image input limits
Base: 256–4,096 pixels per side, up to 5 MB, face at least 128 × 128. Width/height must be strictly between 1:2 and 2:1. Mask must match the base dimensions.Source for Image input limits (opens in a new tab)
Input image formats
JPEG, JPG, PNG, WEBPSource for Input image formats (opens in a new tab)
Mask behavior
Black-and-white mask: white (255) preserves the product region; black (0) marks content to regenerate. Mask matches base dimensions.Source for Mask behavior (opens in a new tab)
Maximum prompt characters
100 characters for prompt and another 100 for face_prompt, separately.Source for Maximum prompt characters (opens in a new tab)

Character limits are not token limits.

Reference image limits
Optional face photo: long side at most 2,048 pixels, face greater than 128 × 128; 5 MB is a recommendation. Optional background: long side at most 4,096, ratio at most 2, at most 5 MB.Source for Reference image limits (opens in a new tab)
Image URL requirements
Public HTTP(S) images; base and mask URLs must not contain Chinese characters.Source for Image URL requirements (opens in a new tab)
Output resolutions
Short side 512 pixels, Short side 1,024 pixelsSource for Output resolutions (opens in a new tab)
Output link expiry
Task status and generated-image URLs are purged after 24 hours. This does not establish input retention or training use.Source for Output link expiry (opens in a new tab)
Generation controls
predefined_face_id is V1-only and takes priority over face_image_url. Documented example IDs: girl1, girl2, girl3, boy1, boy2, boy3; not an exhaustive inventory.Source for Generation controls (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 · trial only

Provider source (opens in a new tab)
API model ID
wanx-virtualmodel
Access
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/virtualmodel/generation. Beijing API key required. Async task submission with X-DashScope-Async: enable; query GET /api/v1/tasks/{task_id}. Async jobs are not Batch API support.
Regions
China (Beijing)
Published request quota
120 requests per minuteSource for Published request quota (opens in a new tab)
Task submission rate
2 task submissions per secondSource for Task submission rate (opens in a new tab)
Quota scope
Per-model limits shared by Alibaba Cloud account and RAM usersSource for Quota scope (opens in a new tab)
Free usage allowance
500 images; 90-day validity from the latest service activation, model release or application approval. Actual account entitlement is not verified.Source for Free usage allowance (opens in a new tab)
Request mode
Async task submission with X-DashScope-Async: enable; query GET /api/v1/tasks/{task_id}. Async jobs are not Batch API support.Source for Request mode (opens in a new tab)
Published token quota
3,000 tokens per minuteSource for Published token quota (opens in a new tab)

Published alongside image-model quotas. It is not an input/context limit or proof of token billing.

Endpoint pricing has not been collected. Check the provider for applicable rates.

Data & enterprise terms

Trial and request contract documented; input retention, training use and 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

Classification inference: separately named native Alibaba hosted release, with no weights in the reviewed related official ReplaceAnything repository. Research identity, demonstration access and hosted V1/V2 weight equivalence are not assumed.

Classification evidence (opens in a new tab)

Lifecycle dates

Model Studio release25 Jun 2024Source (opens in a new tab)

Sources reviewed