> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan Video Generation API

> Wan integration guide - Ace Data Cloud

`POST https://api.acedata.cloud/wan/videos` supports both the existing Wan 2.6 models and `wan3.0-video`. Wan 3 automatically identifies text, first-and-last-frame, or reference material modes based on `media`.

## Wan 3 Text-to-Video

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/wan/videos' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "wan3.0-video",
    "prompt": "A paper boat drifting through a neon city at night",
    "duration": 5,
    "resolution": "720P",
    "ratio": "16:9",
    "audio": true,
    "async": true
  }'
```

Wan 3 supports integer durations of 2–30 seconds or `-1` for smart duration, with resolutions of `480P`, `720P`, and `1080P`.

## Multimedia References

```json theme={null}
{
  "model": "wan3.0-video",
  "prompt": "Create a cinematic product reveal",
  "media": [
    {"type":"first_frame","url":"https://cdn.acedata.cloud/assets/examples/qwen-image/40d5c76b-2f84-4b04-9ea0-b706417ae622-bac6a9e9de22.png"},
    {"type":"last_frame","url":"https://cdn.acedata.cloud/assets/examples/qwen-image/7a5a490c-1d60-4498-a362-a9334148f460-a2a2c1afbf39.png"}
  ],
  "duration": 8,
  "resolution": "1080P",
  "ratio": "16:9",
  "async": true
}
```

`media.type` supports:

* `first_frame` / `last_frame`
* `reference_image`
* `reference_video`
* `reference_audio`
* `file` / `link`

First-and-last-frame mode and reference material mode cannot be used together. Reference videos are ultimately billed based on the actual input video duration plus the successfully generated output video duration; text, image, and audio inputs do not increase video duration.

## Official Standard Pricing

| Resolution | Price |
| - | -: |
| 480P | \$0.05/second |
| 720P | \$0.10/second |
| 1080P | \$0.20/second |

## Wan 2.6 Compatibility

The existing `wan2.6-t2v`, `wan2.6-i2v`, `wan2.6-r2v`, and flash variants continue to use parameters such as `action`, `image_url`, and `reference_video_urls`, with the calling path unchanged.

## Asynchronous Processing and Results

After setting `async: true`, you immediately receive a `task_id`; obtain the final status through `/wan/tasks`. Successfully generated videos will be transferred to the AceDataCloud CDN, and the response will return the actual usage and cost.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.