Skip to main content
Skip to main content

Wan 3.0 Video

Wan 3.0 is the Alibaba Cloud Tongyi Wanxiang team's newest video generation model, and it attacks the two limits that have defined AI video for the past year: clip length and input flexibility. It generates up to 30 seconds in a single pass, and it is the first mainstream video model to accept office documents - doc, xls, ppt, pdf, and md - as generation input, not just text, images, audio, and video.

  • 99.9% SLA
  • Official Discounts
  • Pay-as-you-go
  • Fast & Low Latency
Brand:AlibabaPrice: From $0.055 / sec

API DOCS / SIMPLIFIED

Integrate this model with one task-based API flow

Wan 3.0 is the Alibaba Cloud Tongyi Wanxiang team's newest video generation model, and it attacks the two limits that have defined AI video for the past year: clip length and input flexibility. It generates up to 30 seconds in a single pass, and it is the first mainstream video model to accept office documents - doc, xls, ppt, pdf, and md - as generation input, not just text, images, audio, and video. The examples below are rendered from Wan 3.0 Video, the current gateway base URL, and the selected public model contract.

Input mode
X-API-Key on every request
POST /api/v1/openapi/task
GET /api/v1/openapi/task/status/{task_id}
Async task workflow

Single code window

Switch language once. Each example already includes both the task creation request and the task status polling request.

Unified Example
API_KEY="<API_KEY>"
BASE_URL="https://api.musespark.ai"
REQUEST_BODY='{
  "model_id": "wan-3.0-video",
  "parameters": {
    "prompt": "A cinematic drone shot over a futuristic city at sunrise, volumetric light, realistic motion",
    "resolution": "1080P",
    "duration": 5,
    "aspect_ratio": "adaptive",
    "batch_size": 1
  }
}'

CREATE_RESPONSE=$(curl --request POST "$BASE_URL/api/v1/openapi/task" \
  --header "X-API-Key: $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw "$REQUEST_BODY")

TASK_ID="<TASK_ID_FROM_CREATE_RESPONSE>"

curl "$BASE_URL/api/v1/openapi/task/status/$TASK_ID" \
  --header "X-API-Key: $API_KEY"

Request and response JSON become the documentation

Keep the payload and task status envelope as the primary contract. Field descriptions, optionality, and enum hints now live inline as JSON comments.

Request Body

Caller payload

This is the request envelope accepted by the public gateway for the selected model contract.

Field comments and caller parameters come directly from the current item's model schema.
{
"model_id": "wan-3.0-video",// target model
"parameters": {
"prompt": "A cinematic drone shot over a futuristic city at sunrise, volumetric light, realistic motion",// describe the video in at most 20000 characters; required without reference material and optional with reference material · min 1 · max 20000 · min length 1 · max length 20000
"resolution": "1080P",// output resolution; defaults to 1080P when omitted · enum: 480P | 720P | 1080P
"duration": 5,// output duration in seconds: 2–30, or -1 for model-selected duration · min -1 · max 30
"aspect_ratio": "adaptive",// output video aspect ratio or adaptive sizing · enum: Adaptive | 16:9 | 4:3 | 1:1 | 3:4 | 9:16
"batch_size": 1// standard quantity control field. The allowed range for this item is 1-4 · min 1 · max 4
}
}
Response Body

Gateway response

This is the task status response you will query with task_id until the task reaches a terminal state.

Poll every 2-5 seconds and stop once status becomes completed, failed, cancelled.
{
"code": 200,// 200 on success
"msg": "success",
"data": {
"task_id": "task_01HQX8N2QJ0YQ8Q0T7G6N4V6K2",// use for status polling
"status": "completed",// enum: queued | running | completed | failed | cancelled
"progress": 100,// 0-100 if available
"completed_at": 1760000000,// unix timestamp
"expires_at": 1760001800,// unix timestamp
"result": {
"output_urls": [// generated files
"https://cdn.example.com/output.png"
]
}
}
}