Product-background generation from a transparent foreground, with text, reference-image and layered edge guidance. The documented API selector supports v2 and v3 processing versions.
500 images. API/guide says 180 days after activation; central pricing says 90 days from latest activation, release or approval. Account entitlement unresolved.Source for Free usage allowance (opens in a new tab)
The conflicting 180-day term is preserved from the API and guide, not replaced by an invented common duration.
Per prompt: English up to 150 words; Chinese described as 100–120 characters. Excess is ignored. Applies to positive, negative and individual edge prompts. The exact Chinese cutoff remains ambiguous.Source for Prompt limits (opens in a new tab)
Reference image limits
Reference image may be RGB or RGBA. Fully transparent pixels are excluded from guidance. Reference-image size limits beyond the reviewed format rules remain unverified.Source for Reference image limits (opens in a new tab)
Layer and edge guidance
At most 10 foreground + background elements combined. RGBA layers resize to match the main image, retain bottom-to-top order and may occlude or sit behind the product. Optional prompt lists must match each layer list in length and order; empty strings preserve unprompted positions.Source for Layer and edge guidance (opens in a new tab)
Both use model=wanx-background-generation-v2. Select parameters.model_version; wanx-background-generation-v3 is explicitly rejected as an API model name. Private checkpoint lineage and v3 release date remain unknown.
Generation controls
noise_level: 0–999, default 300, only with an image reference. ref_prompt_weight: 0–1, default 0.5, only when both reference text and image are provided.Source for Generation controls (opens in a new tab)
Guide gives Beijing workspace URLs. API declares Beijing-only scope but uses dashscope-intl in submission examples and mentions Singapore for result queries. No complete Singapore access record is inferred.Source for Regional route evidence (opens in a new tab)
Contradictory API routes are retained in the API source.
Access & pricing
Prices belong to an endpoint and billing tier. A provider listing does not guarantee access for every account or region.
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/background-generation/generation. Async HTTP submission with X-DashScope-Async: enable, followed by task-status queries. This is not Batch API support. Historical guide route; other published routes conflict and current access is unverified.
500 images. API/guide says 180 days after activation; central pricing says 90 days from latest activation, release or approval. Account entitlement unresolved.Source for Free usage allowance (opens in a new tab)
The conflicting 180-day term is preserved from the API and guide, not replaced by an invented common duration.
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; reviewed official model cards and APIs describe service access but do not provide model weights. No exact released checkpoint is identified by those sources. Public Wan checkpoints, style controls and research architectures are not assumed equivalent.
