Project MonetRequest demo
Home/Blog/How to Use Wan 3.0 API: Text, Images, References, Documents & Pricing

AI · Project Monet Briefing

How to Use the Wan 3.0 API

A practical guide to Model Studio's preview API for text, frames, audiovisual references, documents, editing and extension—plus current regional pricing.

Published 2026-08-28 · Updated 2026-08-28 · By Project Monet Editorial Team

Project Monet developer guide graphic for the Wan 3.0 API

01

What you need

Create an Alibaba Cloud Model Studio workspace in a supported region, obtain an API key and use the endpoint for that same region. The official documentation currently marks Wan 3.0 as preview.

The API is asynchronous. Create a task, retain its task ID and poll the matching regional task endpoint. Task IDs remain valid for 24 hours, and completed media URLs are temporary, so copy outputs to your own storage.

02

Model ID and input modes

Use wan3.0-video for the standard all-in-one model. Alibaba also lists wan3.0-video-prime; pricing and availability differ by tier and region.

  • Text-to-video: send a prompt without media and set duration, resolution and aspect ratio.
  • First frame: provide one image with the first-frame media role.
  • First and last frame: provide both roles for controlled interpolation.
  • Reference generation: use images, video and audio as documented reference media.
  • Document or web reference: provide one supported file or one public web link.
  • Editing and extension: provide a source video and an explicit edit or continuation instruction.

03

Current reference and duration limits

The current API reference allows up to 10 reference images, five reference videos totalling no more than 15 seconds, and five reference audio files totalling no more than 15 seconds. It allows one file or one public link in the corresponding reference mode.

Without video input, output can be up to 30 seconds. With video input, source plus output must remain within 30 seconds. First/last-frame mode cannot be combined with reference, file or link mode where Alibaba marks them mutually exclusive.

04

Current API pricing

In Singapore, Alibaba currently lists standard Wan 3.0 at $0.05/$0.10/$0.20 per second for 480p/720p/1080p, under a marked limited-time 30% discount. Prime is listed at $0.068/$0.14/$0.28 per second at the same resolutions.

A simple estimate multiplies the applicable per-second rate by billable input plus output duration. Do not treat the Singapore promotion or its conditional 30-second free quota as a permanent global offer.

05

Production checklist

  • Keep model, workspace, endpoint and API key in the same region.
  • Create the task asynchronously and poll the matching regional endpoint.
  • Store completed outputs before temporary URLs expire.
  • Validate media count, size and duration limits before sending.
  • Treat regional and promotional pricing as time-sensitive.
  • Test shorter, lower-resolution drafts before long 1080p runs.

Sources

Primary and supporting sources

Facts were rechecked against the linked sources immediately before publication. Pricing, product availability and rollout status can change.

Project Monet

Useful signals. Clear decisions. Better digital work.

Project Monet turns relevant shifts in AI, creator tools and the web into practical context—and builds focused websites for businesses ready to grow.

Request a free homepage concept