Wan2.5 Image

Wan2.5 Image
Alibaba Cloud · Image Generation
POST /v1/images/generations

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.

At a glance

FieldValue
Model idwan2-5-image
Model release date2025-09-24
Input modalitiesText, Image
Output modalitiesImage
Context window-
Weight precision-
RegionSingapore
Featuresimage_generation, image_editing
Native inferenceNo
NewNo
Supported endpointsPOST /v1/images/generations
Alternate model idsalibaba/wan-2.5-image, wan2.5-image

Pricing

ChargeSpecRate
Standardper image$0.030

Example request

$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": "a misty forest at dawn", "size": "1024x1024"}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringyes-Text prompt (up to 2000 characters). With input images attached, becomes the editing instruction.
aspect_ratioenumno"1:1"Output aspect ratio. · Allowed: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
imagearrayno-Up to 3 input image URLs. Triggers editing mode.
num_imagesnumberno1Number of images to generate. Each is billed separately. · Range: 1 – 4
negative_promptstringno""What to avoid in the output.
prompt_extendbooleannotrueLet the service rewrite the prompt for better results.
watermarkbooleannofalseAdd a provenance watermark to the output.
seednumberno-Reproducibility seed. Leave empty for random. · Range: 0 – 2147483647
response_formatenumno"url"Return signed URLs or base64 image data. · Allowed: url, b64_json

Notes

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.

Machine-readable schema: GET https://api.empiriolabs.ai/v1/models/wan2-5-image.