Wan 3.0 Video

by AlibabaVideo

Wan 3.0 Video is an Alibaba video generation API on TTAPI. Generate native clips up to 30 seconds from text, frames, reference media, files, and optional audio.

InputMultimodaltext · media · files

Duration2–30 secor smart duration

FlowAsynctask result URL

Price3.5 q/s480P promotional rate

Example clipVideo preview

Examples

Wan 3.0 creator examples

Capabilities

What you can build with Wan 3.0 Video

Native 30-second generation

Generate integer durations from 2 to 30 seconds, or let Wan select a smart duration for the prompt.

Multimodal references

Guide a result with images, video, audio, a webpage, or a document while preserving reference details and timing.

First and last frame control

Constrain the opening frame, or provide both opening and closing frames for a controlled transition.

Synchronized audio

Create video with an audio track by default, or disable audio for silent production workflows.

Pricing

Per-action, in quota

Usage is metered in quota by model, action, and output settings.

Wan 3.0 official channel · limited-time 30% offOfficial pricing

ModelResolutionTTAPI priceOfficial price

wan3.0-video480P3.5 quota / second5 quota / second

wan3.0-video720P7 quota / second10 quota / second

wan3.0-video1080P14 quota / second20 quota / second

API request

Wan 3.0 Video operations and request fields

Use the endpoint below with your TTAPI key and the request fields shown.

Text to videoPOST

/wan/api/v1/services/aigc/video-generation/video-synthesis

Generate a Wan 3.0 video from a text prompt without media input.

Official reference

First framePOST

/wan/api/v1/services/aigc/video-generation/video-synthesis

Generate a video while strictly preserving a supplied first frame.

Official reference

First and last framesPOST

/wan/api/v1/services/aigc/video-generation/video-synthesis

Generate a transition constrained by supplied first and last frames.

Official reference

Reference mediaPOST

/wan/api/v1/services/aigc/video-generation/video-synthesis

Generate from reference images, video, audio, or a web link.

Official reference

Reference filePOST

/wan/api/v1/services/aigc/video-generation/video-synthesis

Generate from a referenced document file that Wan interprets as creative context.

Official reference

FetchGET

/wan/api/v1/tasks/{task_id}

Retrieve task status, generated video URL, and usage by task ID.

Official reference

POSThttps://api.ttapi.io/wan/api/v1/services/aigc/video-generation/video-synthesis

Headers

TT-API-KEYstringrequired

Your TTAPI API key.

Content-Typestringrequired

Use application/json.

Body

modelenumrequired

Use wan3.0-video for the standard Wan 3.0 model.

input.promptstringconditional

Text prompt describing the video. Supports Chinese or English up to 20,000 characters; either a prompt or media input is required.

input.mediaobject[]conditional

Optional media inputs for first/last frames, reference images, reference video, reference audio, a web link, or a document file.

input.media[].typeenumconditional

first_frame, last_frame, reference_image, reference_video, reference_audio, link, or file. Reference media and file/link modes cannot be mixed in one request.

input.media[].urlstringconditional

Public URL or supported Base64 data for the corresponding media item.

parameters.resolutionenumoptional

Output resolution: 480P, 720P, or 1080P. Defaults to 1080P.

parameters.ratioenumoptional

adaptive, 16:9, 4:3, 1:1, 3:4, or 9:16. Defaults to adaptive.

parameters.durationintegeroptional

Output duration from 2 to 30 seconds, or -1 for smart duration. Defaults to 5 seconds.

parameters.audiobooleanoptional

Generate synchronized audio with the video. Defaults to true.

parameters.seedintegeroptional

Seed from 0 to 2,147,483,647 for reproducible generations.

parameters.prompt_extendbooleanoptional

Enable automatic prompt enhancement. Defaults to true.

parameters.watermarkbooleanoptional

Add a watermark when true. Defaults to false.

Open the official TTAPI documentation

Integrate

From key to first result

Copy the resolved endpoint, authentication headers, and request body for this model.

curl --request POST \
  --url https://api.ttapi.io/wan/api/v1/services/aigc/video-generation/video-synthesis \
  --header 'TT-API-KEY: $TTAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"model":"wan3.0-video","input":{"prompt":"这是一个正面的近景镜头，画面主要呈现一位年轻黑人女孩的头部和上半身，她穿着一件蓝色的毕业袍。镜头稍微偏一点点，可以看到左边还有一个人，但背景被虚化处理了，看起来很模糊。女孩正对着镜头说话，嘴巴在动，眉头稍微皱着，表情看起来有点严肃和忧虑。光线从上方照下来，把她脸上的轮廓衬托得很自然，甚至能看到皮肤真实的质感。镜头虽然固定，但带着一点点人手持拍摄时的轻微呼吸感和晃动，视线从看着前面慢慢变成了低头看手里。"},"parameters":{"resolution":"1080P","ratio":"16:9","duration":10,"audio":true,"seed":12345,"prompt_extend":true,"watermark":false}}'