Alibaba Wan 3.0 Text To Video API Documentation

Alibaba Wan 3.0 Text To Video API Documentation

Playground

Wan 3.0 Text to Video generates cinematic videos from text prompts, with flexible 2-30 second duration, aspect ratio control, optional audio, and deep-thinking controls for high-quality video generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Wan 3.0 Text-to-Video generates coherent cinematic videos from natural-language prompts. It supports flexible duration, multiple aspect ratios, optional audio generation, and deep-thinking mode for more deliberate prompt interpretation.

Parameters

How to Use

1. Write your prompt — Describe the scene, subject, motion, camera movement, lighting, and visual style.
2. Choose resolution — Use 480p for lower-cost drafts, 720p for balanced output, or 1080p for higher quality.
3. Set aspect ratio — Select the format that matches your target platform or creative direction.
4. Set duration — Choose a duration from 2 to 30 seconds.
5. Configure audio optional — Keep enable_audio enabled when audio is needed.
6. Enable thinking mode optional — Use thinking_mode when the prompt needs more deliberate interpretation.
7. Submit — Generate the final text-to-video output.

Pricing

Pricing is based on output resolution and billed duration.

Billed duration is rounded up to the next whole second and clamped to the 2–30s range.

Example Costs

Best Use Cases

• Cinematic storytelling — Generate short cinematic scenes from detailed text prompts.
• Concept visualization — Turn written ideas into motion previews for creative planning.
• Social media clips — Create vertical, square, landscape, or widescreen short videos.
• Marketing and advertising — Generate product scenes, brand clips, and promotional visuals.
• Prompt iteration — Test different camera movements, lighting styles, and motion directions.

Pro Tips

• Include subject, action, environment, camera movement, lighting, mood, and visual style in the prompt.
• Use 480p for quick drafts and 1080p for higher-quality output.
• Use shorter durations for iteration, then increase duration once the scene direction is confirmed.
• Enable thinking_mode for complex prompts with multiple visual or motion requirements.
• Set a fixed seed when you want more reproducible results.

Related Models

• Wan 3.0 Text-to-Video — Generate coherent cinematic videos from natural-language prompts.
• Wan 3.0 Image-to-Video — Animate a first-frame image into a coherent video with optional last-frame guidance.
• Wan 3.0 Reference-to-Video — Generate videos using reference images, videos, or audio for multimodal guidance.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "duration": 5,
  "thinking_mode": false,
  "enable_audio": true
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-3.0/text-to-video" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters