Wan2.1 Image API

Alibaba's Wan 2.1 text-to-image model with turbo and plus tiers and up to 1440x1440 output at low per-image pricing.

Alibaba Cloud Image Generation Released Feb 25, 2025 Singapore Proprietary Endpoint

About Wan2.1 Image

Alibaba's Wan 2.1 text-to-image model with turbo and plus tiers and up to 1440x1440 output at low per-image pricing.

Also known as Alibaba Cloud Wan2.1 Image

image generation

Wan2.1 Image specs

Model ID
wan2-1-image
Author
Alibaba Cloud
Category
Image Generation
Released
Feb 25, 2025
Input
Text
Output
Image
Region
Singapore
Endpoints
POST/v1/images/generations
Alternate model IDs
alibaba/wan-2.1-imagewan2.1-image

Wan2.1 Image API pricing

Live pay-as-you-go rates from the EmpirioLabs catalog. You can also choose a plan with weekly allowances.

Type
Spec
Rate
Turbo
per image
$0.025
Plus
per image
$0.05
Compare on the full pricing page

How to call the Wan2.1 Image API

Wan2.1 Image runs through POST /v1/images/generations. The request returns a job_id right away; poll GET /v1/jobs/{job_id} until the job completes and read the output URLs from the result. Or add "sync": true to skip polling: the request stays open and returns the finished OpenAI-style image response directly, so OpenAI SDKs work as-is. Get an API key from the EmpirioLabs dashboard.

cURL: submit the job
curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2-1-image",
    "prompt": "Describe what you want Wan2.1 Image to generate."
  }'
cURL: poll for the result
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "wan2-1-image",
        "prompt": "Describe what you want Wan2.1 Image to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
Full Wan2.1 Image API reference

Wan2.1 Image API parameters

Request parameters supported by the Wan2.1 Image API on EmpirioLabs. Defaults apply when a field is omitted.

ParameterTypeDefaultRange / valuesDescription
promptstring--Text prompt (up to 500 characters).
model_tierenumturboturbo, plusturbo: faster and cheaper. plus: higher fidelity.
aspect_ratioenum1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3Output aspect ratio.
num_imagesnumber11 to 4Number of images to generate. Each is billed separately.
negative_promptstring--What to avoid in the output.
prompt_extendbooleantrue-Let the service rewrite the prompt for better results.
watermarkbooleanfalse-Add a provenance watermark to the output.
seednumber-0 to 2147483647Reproducibility seed. Leave empty for random.
response_formatenumurlurl, b64_jsonReturn signed image URLs by default, or include base64 image data when b64_json is requested.

Good to know

Text-to-image only. Turbo is faster and cheaper; plus is the higher-fidelity tier. Each aspect ratio has one output size, up to 1280 pixels on the long side (1024x1024 at 1:1), with prompts up to 500 characters.

Content safety

  • Generated images pass an automated content-safety check. An image flagged as explicit is not returned. Because the image is generated before the check runs, a flagged generation is still billed.

Wan2.1 Image API: common questions

How much does the Wan2.1 Image API cost?

On EmpirioLabs, Wan2.1 Image is billed pay as you go: Turbo $0.025 per image; Plus $0.05 per image. You can also choose a plan with weekly allowances. The live rate card on this page always matches what the API charges.

What inputs and outputs does Wan2.1 Image support?

Wan2.1 Image takes Text as input and returns Image.

Which endpoint does Wan2.1 Image use?

Wan2.1 Image is served through POST /v1/images/generations on api.empiriolabs.ai with standard bearer-token authentication.

What is the model ID for Wan2.1 Image?

Send wan2-1-image as the model in your request. The alternate IDs alibaba/wan-2.1-image, wan2.1-image also work.

When was Wan2.1 Image released?

Alibaba Cloud released Wan2.1 Image on Feb 25, 2025.

Where is Wan2.1 Image served from?

Wan2.1 Image on EmpirioLabs is served from Singapore.

Can I try Wan2.1 Image in the browser before integrating?

Yes. The EmpirioLabs playground runs Wan2.1 Image in the browser with the same parameters the API exposes, so you can test prompts before writing code.

How do I get a Wan2.1 Image API key?

Create an EmpirioLabs account, then generate a key under API Keys in the dashboard. Billing is pay-as-you-go credits, so you only pay for the requests you make. You can also choose a plan with weekly allowances.

Compare Wan2.1 Image with other models

All model comparisons

Ready to use better endpoints?

Check out our pricing or reach out if you want your own model deployed on our stack.