Skip to main content
POST
Create Wan 3.0 video task
Wan 3.0 uses All-in-One models. Based on media types in input.media and the intent in your prompt, one model can handle text-to-video, first-frame or first-last-frame image-to-video, multimodal reference generation, video editing, and video extension. Unlike Wan 2.7 Video Generation, you do not select separate text, image, or editing models for these capabilities. This endpoint uses the Wan video task protocol. The X-DashScope-Async header is not required because async task semantics are built into the gateway.

Request structure

The request body has three parts: model, input, and parameters. media[].url accepts a publicly accessible HTTP/HTTPS URL, an OSS temporary URL, or a base64 data URI. For a base64 data URI, the gateway stores the asset before sending it upstream.

Authentication

Include the Authorization header in the format Bearer YOUR_API_KEY.

Supported models

Capabilities and media types

Wan 3.0 can generate video with native synchronized audio, up to 30 seconds. Provide assets through input.media:
first_frame / last_frame are mutually exclusive with reference_image / reference_video / reference_audio / file / link. Choose either file or link; either can be combined with reference images, video, and audio. The three reference_* types can be freely combined.
First-frame and first-last-frame mode only accept first_frame and an optional last_frame; do not add audio or other media types. To drive imagery with audio, use multimodal reference mode, for example reference_image plus reference_audio.

Key parameters

For video editing, use reference_video and state the target edit, such as a replacement, removal, or modification, in the prompt. For video extension, explicitly state how to continue or extend the video. For either mode, ratio: "adaptive" and duration: -1 are recommended.

Quick request

This text-to-video request returns a task ID in output.task_id, which you then use to query the result.

Scenario examples

First-last-frame image to video

In first-last-frame mode, provide only the first and last frames. Do not mix in reference_*, file, or link.

File-reference generation

Provide at most one file, and do not combine it with link. This mode must enable or omit prompt_extend.

Web-page and reference-image generation

Use a publicly accessible, no-login page for link. It can be combined with reference media such as reference_image.

Multimodal reference generation

Reference images, videos, and audio can be combined. Images, videos, and audio are each numbered in their array order.

Video editing

Use reference_video and state the requested edit directly.

Video extension

Use reference_video and explicitly describe the continuation direction or next scene.
A successful creation returns the task ID:

Next steps

Headers

Authorization
string
required

API key in the format Bearer YOUR_API_KEY

Example:

"Bearer YOUR_API_KEY"

Content-Type
string
required

Request body type

Example:

"application/json"

Body

application/json
model
string
required

Wan 3.0 All-in-One model identifier: wan3.0-video or wan3.0-video-prime

input
object
required

Input content (prompt and media elements)

parameters
object

Generation parameters

Response

200 - application/json

Task created successfully

request_id
string

Gateway request ID

output
object