Wan2.5 Image API

About Wan2.5 Image

Alibaba's Wan 2.5 image model with text-to-image and multi-reference editing of up to 3 images at about 1.7 megapixels.

Also known as Alibaba Cloud Wan2.5 Image

Wan2.5 Image specs

Model ID

wan2-5-image

Provider

Alibaba Cloud

Category

Image Generation

Released

Sep 24, 2025

Input

TextImage

Output

Image

Region

Singapore

Endpoints

POST/v1/images/generations

Alternate model IDs

alibaba/wan-2.5-imagewan2.5-image

Wan2.5 Image API pricing

Live pay-as-you-go rates from the EmpirioLabs catalog. You are billed only for what you use, with no monthly minimum.

How to call the Wan2.5 Image API

Wan2.5 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 https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2-5-image",
    "prompt": "Describe what you want Wan2.5 Image to generate."
  }'

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "wan2-5-image",
        "prompt": "Describe what you want Wan2.5 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)

Wan2.5 Image API parameters

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

Good to know

Text-to-image renders about 1.7 megapixels at the chosen aspect ratio; attach 1 to 3 images for editing and fusion at about 1 megapixel. Prompts up to 2000 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.5 Image API: common questions

How much does the Wan2.5 Image API cost?

On EmpirioLabs, Wan2.5 Image is billed pay as you go: Standard $0.030 per image. The live rate card on this page always matches what the API charges.

Which endpoint does Wan2.5 Image use?

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

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

Yes. The EmpirioLabs playground runs Wan2.5 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.5 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.