> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# 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.

![Wan2.1 Image](https://media.empiriolabs.ai/model-logos/wan.png)

[Alibaba Cloud](/providers/alibaba) · Image Generation

`POST /v1/images/generations`

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

## At a glance

| Field               | Value                                   |
| ------------------- | --------------------------------------- |
| Model id            | `wan2-1-image`                          |
| Model release date  | 2025-02-25                              |
| Input modalities    | Text                                    |
| Output modalities   | Image                                   |
| Context window      | -                                       |
| Weight precision    | -                                       |
| Region              | Singapore                               |
| Features            | image_generation                        |
| Native inference    | No                                      |
| New                 | No                                      |
| Supported endpoints | `POST /v1/images/generations`           |
| Alternate model ids | `alibaba/wan-2.1-image`, `wan2.1-image` |

## Pricing

| Charge | Spec      | Rate    |
| ------ | --------- | ------- |
| Turbo  | per image | \$0.025 |
| Plus   | per image | \$0.05  |

## Example request

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

## Parameters

| Parameter         | Type    | Required | Default   | Description                                                                                                                |
| ----------------- | ------- | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------- |
| `prompt`          | string  | yes      | -         | Text prompt (up to 500 characters).                                                                                        |
| `model_tier`      | enum    | no       | `"turbo"` | turbo: faster and cheaper. plus: higher fidelity. · Allowed: `turbo`, `plus`                                               |
| `aspect_ratio`    | enum    | no       | `"1:1"`   | Output aspect ratio. · Allowed: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`                                          |
| `num_images`      | number  | no       | `1`       | Number of images to generate. Each is billed separately. · Range: 1 – 4                                                    |
| `negative_prompt` | string  | no       | `""`      | What to avoid in the output.                                                                                               |
| `prompt_extend`   | boolean | no       | true      | Let the service rewrite the prompt for better results.                                                                     |
| `watermark`       | boolean | no       | false     | Add a provenance watermark to the output.                                                                                  |
| `seed`            | number  | no       | -         | Reproducibility seed. Leave empty for random. · Range: 0 – 2147483647                                                      |
| `response_format` | enum    | no       | `"url"`   | Return signed image URLs by default, or include base64 image data when b64_json is requested. · Allowed: `url`, `b64_json` |

## Notes

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.

---

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