Wan API

Wan Video Generation
Turn Assets into Shots

Turn text and reference assets into videos, with first/last frame control and multimedia references. Integrate into your own creative workflow through a unified API.

View DocumentationView Pricing
2–30sIntelligent or specified duration
480P–1080PThree output specifications
7 types of mediaUnified media input
Input + OutputBilled by actual video seconds

Define shots with assets, not just descriptions

One API covers text-to-video, first/last frames, reference images, reference videos, and audio-driven generation, automatically selecting the appropriate generation mode.

Text Creation

Generate complete shots from prompts, ideal for concept videos, social content, and video drafts.

First/Last Frame Control

Lock the opening and closing frames for greater control over motion, subject positioning, and transition direction.

Multimedia References

Use images, videos, or audio to reference characters, actions, styles, and rhythm without switching APIs.

first_framelast_framereference_imagereference_videoreference_audiofilelink

Real Production Videos

Both videos were generated by the production API and transferred to the AceDataCloud CDN for direct playback and verification.

Text to video · 480P · 2sFixed camera, red sphere in a white studio. 2-second output, list cost 1.16 Credits。
Reference video output · 480P · 2sGenerated from a 2-second reference video; 2 seconds of input plus 2 seconds of output, 4 seconds billed in total, list cost 2.1024734982332154 Credits。

Keep request structure simple; let assets express the mode

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 red ball on a white studio floor",
    "duration": 2,
    "resolution": "480P",
    "ratio": "16:9",
    "async": true
  }'
{
  "success": true,
  "task_id": "9478f7ee-5ebb-47ac-ab49-63fbb42d8233",
  "data": {
    "status": "succeeded",
    "usage": {
      "input_video_duration": 0,
      "output_video_duration": 2,
      "SR": 480,
      "ratio": "16:9"
    }
  },
  "cost": {"list_amount": 1.16}
}

Production verification trace: 087bbe73-e336-4b4a-a410-c56d54c763b8。Async tasks can be queried through theTasks API, and polling does not incur duplicate charges.

Price display and final billing each serve their own purpose

The Pricing tab displays the standard price per second by resolution; the final bill is calculated based on the actual input video seconds and successful output seconds in the response usage.

480P

Ideal for quick previews, shot drafts, and mobile content.

720P

Ideal for everyday publishing, social content, and product demonstrations.

1080P

Ideal for high-quality final videos, detailed visuals, and large-screen displays.

Credit and USD prices per second are displayed in real time on this page's Pricing tab; static prices are not duplicated in the introductory text.

Frequently Asked Questions

What does duration=-1 mean?

Enables smart duration. Pre-authorization is checked against an upper limit of 30 seconds, and final billing is still based on actual usage after completion.

How are reference videos billed?

Input reference video seconds and successful output video seconds are added together; image, audio, and text inputs do not add video seconds.

Where can I view the complete media fields?

See the Wan Video Generation API documentation; field constraints and response structures are governed by this documentation.

Integrate multimodal video generation into your workflow

Start with text-based shots, then add frame, video, image, and audio references as needed.

Get API Key