Wan 3.0 官方 API 的模型 ID 是什麼？

Alibaba Cloud 的官方 API 使用模型 ID `wan3.0-video`。CometAPI 目前將其對應的目錄模型列為 `wan3.0`。

Wan 3.0 與 Wan 2.7 有何不同？

Wan 3.0 將單次生成影片延長至 30 秒，並新增更廣泛的 Omni-Reference 能力，包括將文件與網頁作為創作輸入。

Wan 3.0 API 支援哪些解析度？

Wan 3.0 支援 480P、720P 與 1080P 輸出。官方 API 文件未列出 4K 輸出。

Wan 3.0 是否會與影片同時生成音訊？

是的。Wan 3.0 支援原生影音生成，官方 API 提供的 audio 參數預設為啟用。

Wan 3.0 能否將 PDF 或 PowerPoint 轉成影片？

是的。Wan 3.0 支援基於文件的生成，接受的格式包括 DOC、XLS、PPT、PDF、TXT、KEY、PAGES、NUMBERS 與 MD；限制為 1 個檔案或連結，大小上限 100 MB、最多 50 頁。

Wan 3.0 能否在一次 API 呼叫中生成 30 秒影片？

是的。Wan 3.0 支援單次生成最長 30 秒的原生影片，並具備智慧時長與影片延伸能力。

Wan 3.0 是否可使用多個參考圖片、影片與音訊檔案？

是的。Wan 3.0 支援基於參考的生成，可使用圖片、影片、音訊與其他支援的媒體，並可透過參考來控制角色、物件、環境與動作。

Aliyun

可使用熱門

wan3.0

Wan3.0 API

從快速驗證到電影級輸出，計費以所生成影片的片長為基準、選擇合適的解析度，並將每次生成轉化為有規劃的創意投資的活動規則

起始價格

$0.04 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

Aug 24, 2026

Aliyun

Playground

透過實際請求試用 Wan3.0,檢視參數並在整合 API 前驗證輸出結果。

概覽

Wan3.0 的實用總覽,涵蓋重要行為與整合注意事項。

Wan 3.0 的技術規格

規格	Wan 3.0
模型類型	多模態一體化影片生成模型
模型狀態	公開 API 預覽
輸入類型	文字、圖片、影片、音訊、文件、網頁
影片生成	文字轉影片、圖片轉影片、參考轉影片
影片編輯	基於指令與基於參考的編輯
最大時長	單次生成 30 秒
輸出解析度	480P, 720P, 1080P
原生視聽生成	是
參考資產	最多 20 個多模態參考資產
文件輸入	DOC, XLS, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD
最大文件大小	100 MB
最大文件頁數	50 頁
API 存取	Alibaba Cloud Model Studio API 預覽
API 生成模式	非同步
480P 價格	$0.05/sec
720P 價格	$0.10/sec
1080P 價格	$0.20/sec

Wan 3.0 是 Alibaba Cloud 最新的一體化多模態影片生成模型，已於 2026 年 8 月正式發佈。 相較於先前的 Wan 系列，其最突出的升級不僅是更高的視覺品質，而是將文字、圖片、影片、音訊、文件與網頁整合進單一創作流程。Alibaba Cloud 表示該模型支援原生 30 秒影片生成、多模態參考輸入、同步視聽生成與精準影片編輯。

什麼是 Wan 3.0？

Wan 3.0 是 Alibaba 的新一代多模態影片生成模型，旨在將文字、圖片、影片、音訊、文件與網路內容轉化為連貫的影片。

早期的 AI 影片工作流程通常需要多個專用模型：一個負責文字轉影片、另一個負責圖片轉影片、再有一個保證參考一致性，並且需要獨立的剪輯或音訊工具。Wan 3.0 邁向一體化製作模型，讓這些輸入可以圍繞單一創作指令進行組合。

其核心能力是原生 30 秒生成。不再是生成 5 或 10 秒的短片再反覆延長與拼接，Wan 3.0 可一次性生成連續 30 秒的序列。Alibaba 的展示顯示，該模型能在較長場景中維持角色、環境、動作、鏡頭運動、對白與聲音的一致。

另一項重大變化是Omni-Reference。開發者可使用多個參考資產來確立角色、產品、環境、動作或其他視覺特徵。官方的 Wan 3.0 儲存庫描述支援最多 20 個參考資產；而 Alibaba Cloud 的產品頁則強調可將圖片、文字、影片、音訊、文件與網頁結合為創作參考。

這使得 Wan 3.0 更像是一個多模態創意製作引擎，而非簡單的提示詞到影片生成器。

Wan 3.0 的主要功能

原生 30 秒影片生成： Wan 3.0 可在單次生成中產出最長 30 秒的影片，並具備智慧時長選擇與影片延展能力。
Omni-Reference： 可將文字、圖片、影片與音訊作為參考結合使用；Wan 3.0 亦將基於參考的生成拓展至文件與網頁。
文件轉影片： 可將 PPT、PDF、DOC、XLS、TXT、KEY、PAGES、NUMBERS 與 MD 作為創作輸入，讓簡報、報告與結構化資訊成為影片內容。
原生視聽生成： 可同時生成影片與聲音，支援對白、環境音與以音樂為導向的視聽場景。
參考一致性： 該模型旨在於參考驅動的生成中，保留角色、道具、環境、空間關係與風格。
影片編輯： 支援對已生成內容進行修改，包括視覺元素、劇情與對白，無需每次從頭開始。

Wan 3.0 與其他影片模型的比較

模型	原生時長	圖片轉影片	參考控制	音訊	文件/網頁輸入	主要優勢
Wan 3.0	30s	✓	強	✓	✓	一體化多模態製作
Wan 2.7	15s	✓	✓	✓	受限	成熟的 Wan 影片工作流程
Grok Imagine Video 1.5	最長 15s	✓	✓	✓	—	快速短影片創作
Veo	依模型而定	✓	✓	✓	多模態	電影級生成
Kling	依模型而定	✓	✓	✓	—	角色與動作生成
Seedance	依模型而定	✓	✓	✓	—	創意與多鏡頭影片

關鍵差異在於輸入的廣度。

相較於 Grok Imagine Video 1.5，Wan 3.0 在一體化製作工作流程上邁得更遠。Grok 專注於以文字、圖片與參考為核心的短影片生成，而 Wan 3.0 進一步將文件、網頁、音訊與影片納入直接的創作參考。

相較於 Wan 2.7，最大的架構與產品層變化在於邁向統一的多模態工作流程，以及原生 30 秒生成上限，不同於上一代較短的片段。Alibaba Cloud 目前對 Wan 3.0 的介紹明確將其定位於長篇敘事與 Omni-Reference 生成。

相較於 Kling 與 Veo，Wan 3.0 的最強差異不必然在於每一幀都更好，而在於能結合大量來源素材，並於較長的生成過程中維持這些資訊的一致。

若應用僅是「寫一段提示詞並生成電影感短片」，其他模型可能依然具有競爭力。若工作流程是「這裡有產品圖片、角色參考、PDF、試算表、音訊樣本與創作簡述——將它們變成一支連貫的影片」，Wan 3.0 則更具吸引力。

Wan 3.0 的代表性使用場景

1. AI 電影與故事製作

單次 30 秒生成能力適用於需要連續鏡頭運動、對白與多個動作的場景，無需拼接大量短片。

2. 產品廣告

可將產品圖片或一組參考與導演式提示結合，生成產品展示、UGC 廣告與電影感品牌影片。

3. 簡報轉影片生成

Wan 3.0 可處理 PPT、PDF、DOC、XLS 與其他受支援的文件格式，適合將報告、簡報與結構化資訊轉化為視覺敘事。

4. 角色一致的影片

可利用參考圖片、影片與其他媒體建立角色、物件與環境，再生成場景。

5. 社群媒體內容

30 秒時長與縱向 9:16 長寬比，使 Wan 3.0 適用於短影音、廣告與敘事片段。

6. 影片編輯與迭代

Wan 3.0 可修改既有生成內容，包括視覺元素、故事內容與對白，支援迭代的創作流程。

Wan 3.0 API 參數

官方 API 採用非同步影片生成端點。精簡的請求包含 model、input 與 parameters 物件。

重要參數包括：

參數	說明
model	wan3.0-video
input.prompt	導演風格的生成指令
input.media	參考圖片、影片、音訊、文件或網路資源
parameters.resolution	480P, 720P, 1080P
parameters.ratio	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16
parameters.duration	2–30 秒；-1 啟用智慧時長
parameters.audio	是否包含音訊軌
parameters.seed	可重現性的隨機種子
parameters.watermark	是否加入浮水印

官方文件指出，當未提供影片輸入時，duration 可為 2 至 30 秒的整數；當提供影片輸入時，輸入與輸出時長合計需保持在支援的總時長範圍內。

如何在 CometAPI 上使用 Wan 3.0 API

對於同時使用多個 AI 影片模型的開發者，CometAPI 可作為統一的存取層，用於與其他影片生成模型一同實驗 Wan 3.0。

典型工作流程如下：

建立或登入 CometAPI 帳號。
取得 CometAPI API 金鑰。
選擇 Wan 3.0 模型端點。
提交文字轉影片、圖片轉影片或基於參考的生成請求。
指定解析度、時長、長寬比與其他受支援的參數。
監控非同步生成任務。
當處理完成時取回生成的影片。

在實作前，應根據當前的 CometAPI Wan 3.0 整合情況核對具體端點與受支援參數，特別是因為上游的 Alibaba API 仍處於預覽階段。

常見問題

定價

先參考上方的單次執行預估,再查看完整的 CometAPI 與官方價格比較。

5 秒測試

$0.2

預估 CometAPI 使用費用

10 秒測試

$0.4

預估 CometAPI 使用費用

15 秒測試

$0.6

預估 CometAPI 使用費用

Wan3.0 的定價

探索 Wan3.0 的競爭性定價，專為滿足各種預算和使用需求而設計。我們靈活的方案確保您只需為實際使用量付費，讓您能夠隨著需求增長輕鬆擴展。了解 Wan3.0 如何在保持成本可控的同時提升您的專案效果。

Wan 3.0 Video Generation Pricing

From fast verification to cinematic output, billing is based on generated video duration and the selected resolution, turning every generation into a planned creative investment.

Customer-facing model: wan3.0

Output Resolution	Price per Generated Second	5-Second Video
480P	$0.05	$0.25
720P	$0.10	$0.50
1080P	$0.20	$1.00

Supported duration: 2–30 seconds
Billing unit: generated video second
Choose the appropriate output resolution for each generation
Final charge = applicable resolution price × successfully generated video duration

API

複製可用的端點與程式碼範例,需要完整參數時再開啟完整 API 參考文件。

一個 API,直接對接正式環境模型

只需驗證一次,即可呼叫模型端點,並在各供應商間維持一致的計費與監控流程。

POST/v1/videosGET/v1/videos/{task_id}/contentGET/v1/videos/{task_id}

Wan3.0 的範例程式碼和 API

存取完整的範例程式碼和 API 資源，以簡化您的 Wan3.0 整合流程。我們詳盡的文件提供逐步指引，協助您在專案中充分發揮 Wan3.0 的潛力。

POST

/v1/videos

GET

/v1/videos/{task_id}/content

GET

/v1/videos/{task_id}

response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F prompt='A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080) || exit 1

video_id=$(printf '%s' "$response" | sed -n 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
if [ -z "$video_id" ]; then
  printf 'Missing video ID: %s
' "$response" >&2
  exit 1
fi
printf 'Video ID: %s
' "$video_id"

polls=0
while [ "$polls" -lt 54 ]; do
  status_response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY") || exit 1
  progress=$(printf '%s' "$status_response" | sed -n 's/.*"progress"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  status=$(printf '%s' "$status_response" | sed -n 's/.*"status"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  printf 'Progress: %s, Status: %s
' "${progress:-0%}" "${status:-unknown}"
  case "$status" in
    FAILURE|failure|failed|error|cancelled|canceled) exit 1 ;;
    completed|succeeded|success) break ;;
  esac
  [ "$progress" = "100%" ] && break
  polls=$((polls + 1))
  sleep 10
done
if [ "$polls" -ge 54 ]; then
  echo "Video generation did not complete within 9 minutes" >&2
  exit 1
fi

mkdir -p output
output_path="output/${video_id}.mp4"
curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "$output_path"
printf 'Saved: %s (%s bytes)
' "$output_path" "$(wc -c < "$output_path")"

cURL Code Example

response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F prompt='A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080) || exit 1

video_id=$(printf '%s' "$response" | sed -n 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
if [ -z "$video_id" ]; then
  printf 'Missing video ID: %s\n' "$response" >&2
  exit 1
fi
printf 'Video ID: %s\n' "$video_id"

polls=0
while [ "$polls" -lt 54 ]; do
  status_response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY") || exit 1
  progress=$(printf '%s' "$status_response" | sed -n 's/.*"progress"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  status=$(printf '%s' "$status_response" | sed -n 's/.*"status"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  printf 'Progress: %s, Status: %s\n' "${progress:-0%}" "${status:-unknown}"
  case "$status" in
    FAILURE|failure|failed|error|cancelled|canceled) exit 1 ;;
    completed|succeeded|success) break ;;
  esac
  [ "$progress" = "100%" ] && break
  polls=$((polls + 1))
  sleep 10
done
if [ "$polls" -ge 54 ]; then
  echo "Video generation did not complete within 9 minutes" >&2
  exit 1
fi

mkdir -p output
output_path="output/${video_id}.mp4"
curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "$output_path"
printf 'Saved: %s (%s bytes)\n' "$output_path" "$(wc -c < "$output_path")"

Python Code Example

import os
import time
from pathlib import Path

import requests

# Get your API key from https://www.cometapi.com/console/token, and paste it here
API_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com".rstrip("/")

response = requests.post(
    f"{BASE_URL}/v1/videos",
    headers={"Authorization": f"Bearer {API_KEY}"},
    files={
        "model": (None, "wan3.0"),
        "prompt": (None, "A small robot walks through a bright greenhouse with smooth camera movement."),
        "seconds": (None, "5"),
        "size": (None, "1920x1080"),
    },
    timeout=120,
)
response.raise_for_status()
video_id = response.json()["id"]
print(f"Video ID: {video_id}")

deadline = time.monotonic() + 540
while time.monotonic() < deadline:
    response = requests.get(
        f"{BASE_URL}/v1/videos/{video_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=120,
    )
    response.raise_for_status()
    result = response.json()
    data = result.get("data") or result
    progress = data.get("progress", result.get("progress", "0%"))
    status = str(data.get("status", result.get("status", "unknown")))
    print(f"Progress: {progress}, Status: {status}")
    if status.lower() in {"failure", "failed", "error", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {result}")
    if progress == "100%" or status.lower() in {"completed", "succeeded", "success"}:
        break
    time.sleep(10)
else:
    raise TimeoutError("Video generation did not complete within 9 minutes")

response = requests.get(
    f"{BASE_URL}/v1/videos/{video_id}/content",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=120,
)
response.raise_for_status()
output_path = Path("output") / f"{video_id}.mp4"
output_path.parent.mkdir(parents=True, exist_ok=True)
output_path.write_bytes(response.content)
print(f"Saved: {output_path} ({output_path.stat().st_size} bytes)")

JavaScript Code Example

import { mkdir, writeFile } from "node:fs/promises";

// Get your API key from https://www.cometapi.com/console/token, and paste it here
const apiKey = process.env["COMETAPI_KEY"] || "<YOUR_COMETAPI_KEY>";
const baseUrl = "https://api.cometapi.com".replace(/\/$/, "");

const form = new FormData();
form.append("model", "wan3.0");
form.append("prompt", "A small robot walks through a bright greenhouse with smooth camera movement.");
form.append("seconds", "5");
form.append("size", "1920x1080");

let response = await fetch(`${baseUrl}/v1/videos`, {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}` },
  body: form,
});
if (!response.ok) throw new Error(await response.text());
const { id: videoId } = await response.json();
console.log(`Video ID: ${videoId}`);

const deadline = Date.now() + 540_000;
let completed = false;
while (Date.now() < deadline) {
  response = await fetch(`${baseUrl}/v1/videos/${videoId}`, {
    headers: { Authorization: `Bearer ${apiKey}` },
  });
  if (!response.ok) throw new Error(await response.text());
  const result = await response.json();
  const data = result.data || result;
  const progress = data.progress || result.progress || "0%";
  const status = String(data.status || result.status || "unknown");
  console.log(`Progress: ${progress}, Status: ${status}`);
  if (["failure", "failed", "error", "cancelled", "canceled"].includes(status.toLowerCase())) {
    throw new Error(`Video generation failed: ${JSON.stringify(result)}`);
  }
  if (progress === "100%" || ["completed", "succeeded", "success"].includes(status.toLowerCase())) {
    completed = true;
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 10_000));
}
if (!completed) throw new Error("Video generation did not complete within 9 minutes");

response = await fetch(`${baseUrl}/v1/videos/${videoId}/content`, {
  headers: { Authorization: `Bearer ${apiKey}` },
});
if (!response.ok) throw new Error(await response.text());
const video = Buffer.from(await response.arrayBuffer());
await mkdir("output", { recursive: true });
const outputPath = `output/${videoId}.mp4`;
await writeFile(outputPath, video);
console.log(`Saved: ${outputPath} (${video.length} bytes)`);

功能

在選擇架構或評估正式環境負載前,先掌握模型的關鍵資訊。

支援的功能

現有模型 API 回傳的功能。

text-to-video

image-to-video

video-editing

輸入與輸出

輸入

text

輸出

video

正式環境資訊

供應商: Aliyun
上下文: 依模型而定
商業使用: 支援

應用場景

將 Wan3.0 用於符合其 video 能力的正式工作流程,並在長期整合前比較其他選項。

文字轉影片的概念與社群內容

產品展示與電影感分鏡

圖像轉影片動態與創意迭代

其他模型

比較 CometAPI 提供的其他模型,在品質、延遲、功能與價格間取得平衡。

開啟模型比較 →

Flux

Flux 3

FLUX 3 - 真實世界模型：邁向以多模態流模型作為視覺智能的骨幹。

查看模型

Aliyun

Happy Horse 1.1

HappyHorse 1.1 是一款面向專業內容創作、廣告、短片、社群媒體製作與敘事的多模態影片生成模型。它在 HappyHorse 1.0 的基礎上擴展能力——該版本曾在獨立的影片生成評測中名列前茅，因而獲得廣泛關注——並具備更強的場景連貫性與更高的視覺保真度。

查看模型

OpenAI

Sora 2 Pro

Sora 2 Pro 是我們最先進且最強大的媒體生成模型，能生成帶有同步音訊的影片。它可以從自然語言或圖像創建細節豐富、動態的影片片段。

查看模型

Aliyun

Happy Horse 1.0

Happy Horse 1.0 — 一款高品質的影音生成模型，支援文字轉影片與圖片轉影片創作。它可生成畫面、音訊與口型的同步效果，適用於短片、廣告創意與產品展示。

查看模型

OpenAI

Sora 2

超強大的影片生成模型，具備音效，支援對話格式。

查看模型

MiniMax

MiniMax H3

minimax-h3 是一款為高品質創意製作而設計的全新影片生成模型。它在提示詞理解、視覺一致性、畫面運動的流暢度，以及參考圖像控制的靈活性方面均有提升，適用於電影級影片生成工作流程。

查看模型

Uptime

在正式上線前,查看即時心跳資料、端點可用性與實測回應時間。

版本

在鎖定正式環境整合版本前,先查看可用的模型識別碼。

wan3.0

持續探索

比較模型,繼續你的研究

Aliyun

可使用熱門

wan3.0

Wan3.0 API

從快速驗證到電影級輸出，計費以所生成影片的片長為基準、選擇合適的解析度，並將每次生成轉化為有規劃的創意投資的活動規則

起始價格

$0.04 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

Aug 24, 2026

Aliyun

Playground

透過實際請求試用 Wan3.0,檢視參數並在整合 API 前驗證輸出結果。

概覽

Wan3.0 的實用總覽,涵蓋重要行為與整合注意事項。

Wan 3.0 的技術規格

規格	Wan 3.0
模型類型	多模態一體化影片生成模型
模型狀態	公開 API 預覽
輸入類型	文字、圖片、影片、音訊、文件、網頁
影片生成	文字轉影片、圖片轉影片、參考轉影片
影片編輯	基於指令與基於參考的編輯
最大時長	單次生成 30 秒
輸出解析度	480P, 720P, 1080P
原生視聽生成	是
參考資產	最多 20 個多模態參考資產
文件輸入	DOC, XLS, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD
最大文件大小	100 MB
最大文件頁數	50 頁
API 存取	Alibaba Cloud Model Studio API 預覽
API 生成模式	非同步
480P 價格	$0.05/sec
720P 價格	$0.10/sec
1080P 價格	$0.20/sec

什麼是 Wan 3.0？

Wan 3.0 是 Alibaba 的新一代多模態影片生成模型，旨在將文字、圖片、影片、音訊、文件與網路內容轉化為連貫的影片。

這使得 Wan 3.0 更像是一個多模態創意製作引擎，而非簡單的提示詞到影片生成器。

Wan 3.0 的主要功能

原生 30 秒影片生成： Wan 3.0 可在單次生成中產出最長 30 秒的影片，並具備智慧時長選擇與影片延展能力。
Omni-Reference： 可將文字、圖片、影片與音訊作為參考結合使用；Wan 3.0 亦將基於參考的生成拓展至文件與網頁。
文件轉影片： 可將 PPT、PDF、DOC、XLS、TXT、KEY、PAGES、NUMBERS 與 MD 作為創作輸入，讓簡報、報告與結構化資訊成為影片內容。
原生視聽生成： 可同時生成影片與聲音，支援對白、環境音與以音樂為導向的視聽場景。
參考一致性： 該模型旨在於參考驅動的生成中，保留角色、道具、環境、空間關係與風格。
影片編輯： 支援對已生成內容進行修改，包括視覺元素、劇情與對白，無需每次從頭開始。

Wan 3.0 與其他影片模型的比較

模型	原生時長	圖片轉影片	參考控制	音訊	文件/網頁輸入	主要優勢
Wan 3.0	30s	✓	強	✓	✓	一體化多模態製作
Wan 2.7	15s	✓	✓	✓	受限	成熟的 Wan 影片工作流程
Grok Imagine Video 1.5	最長 15s	✓	✓	✓	—	快速短影片創作
Veo	依模型而定	✓	✓	✓	多模態	電影級生成
Kling	依模型而定	✓	✓	✓	—	角色與動作生成
Seedance	依模型而定	✓	✓	✓	—	創意與多鏡頭影片

關鍵差異在於輸入的廣度。

相較於 Kling 與 Veo，Wan 3.0 的最強差異不必然在於每一幀都更好，而在於能結合大量來源素材，並於較長的生成過程中維持這些資訊的一致。

Wan 3.0 的代表性使用場景

1. AI 電影與故事製作

單次 30 秒生成能力適用於需要連續鏡頭運動、對白與多個動作的場景，無需拼接大量短片。

2. 產品廣告

可將產品圖片或一組參考與導演式提示結合，生成產品展示、UGC 廣告與電影感品牌影片。

3. 簡報轉影片生成

Wan 3.0 可處理 PPT、PDF、DOC、XLS 與其他受支援的文件格式，適合將報告、簡報與結構化資訊轉化為視覺敘事。

4. 角色一致的影片

可利用參考圖片、影片與其他媒體建立角色、物件與環境，再生成場景。

5. 社群媒體內容

30 秒時長與縱向 9:16 長寬比，使 Wan 3.0 適用於短影音、廣告與敘事片段。

6. 影片編輯與迭代

Wan 3.0 可修改既有生成內容，包括視覺元素、故事內容與對白，支援迭代的創作流程。

Wan 3.0 API 參數

官方 API 採用非同步影片生成端點。精簡的請求包含 model、input 與 parameters 物件。

重要參數包括：

參數	說明
model	wan3.0-video
input.prompt	導演風格的生成指令
input.media	參考圖片、影片、音訊、文件或網路資源
parameters.resolution	480P, 720P, 1080P
parameters.ratio	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16
parameters.duration	2–30 秒；-1 啟用智慧時長
parameters.audio	是否包含音訊軌
parameters.seed	可重現性的隨機種子
parameters.watermark	是否加入浮水印

官方文件指出，當未提供影片輸入時，duration 可為 2 至 30 秒的整數；當提供影片輸入時，輸入與輸出時長合計需保持在支援的總時長範圍內。

如何在 CometAPI 上使用 Wan 3.0 API

對於同時使用多個 AI 影片模型的開發者，CometAPI 可作為統一的存取層，用於與其他影片生成模型一同實驗 Wan 3.0。

典型工作流程如下：

建立或登入 CometAPI 帳號。
取得 CometAPI API 金鑰。
選擇 Wan 3.0 模型端點。
提交文字轉影片、圖片轉影片或基於參考的生成請求。
指定解析度、時長、長寬比與其他受支援的參數。
監控非同步生成任務。
當處理完成時取回生成的影片。

在實作前，應根據當前的 CometAPI Wan 3.0 整合情況核對具體端點與受支援參數，特別是因為上游的 Alibaba API 仍處於預覽階段。

常見問題

定價

先參考上方的單次執行預估,再查看完整的 CometAPI 與官方價格比較。

5 秒測試

$0.2

預估 CometAPI 使用費用

10 秒測試

$0.4

預估 CometAPI 使用費用

15 秒測試

$0.6

預估 CometAPI 使用費用

Wan3.0 的定價

Wan 3.0 Video Generation Pricing

From fast verification to cinematic output, billing is based on generated video duration and the selected resolution, turning every generation into a planned creative investment.

Customer-facing model: wan3.0

Output Resolution	Price per Generated Second	5-Second Video
480P	$0.05	$0.25
720P	$0.10	$0.50
1080P	$0.20	$1.00

Supported duration: 2–30 seconds
Billing unit: generated video second
Choose the appropriate output resolution for each generation
Final charge = applicable resolution price × successfully generated video duration

API

複製可用的端點與程式碼範例,需要完整參數時再開啟完整 API 參考文件。

一個 API,直接對接正式環境模型

只需驗證一次,即可呼叫模型端點,並在各供應商間維持一致的計費與監控流程。

POST/v1/videosGET/v1/videos/{task_id}/contentGET/v1/videos/{task_id}

Wan3.0 的範例程式碼和 API

存取完整的範例程式碼和 API 資源，以簡化您的 Wan3.0 整合流程。我們詳盡的文件提供逐步指引，協助您在專案中充分發揮 Wan3.0 的潛力。

POST

/v1/videos

GET

/v1/videos/{task_id}/content

GET

/v1/videos/{task_id}

response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F prompt='A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080) || exit 1

video_id=$(printf '%s' "$response" | sed -n 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
if [ -z "$video_id" ]; then
  printf 'Missing video ID: %s
' "$response" >&2
  exit 1
fi
printf 'Video ID: %s
' "$video_id"

polls=0
while [ "$polls" -lt 54 ]; do
  status_response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY") || exit 1
  progress=$(printf '%s' "$status_response" | sed -n 's/.*"progress"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  status=$(printf '%s' "$status_response" | sed -n 's/.*"status"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  printf 'Progress: %s, Status: %s
' "${progress:-0%}" "${status:-unknown}"
  case "$status" in
    FAILURE|failure|failed|error|cancelled|canceled) exit 1 ;;
    completed|succeeded|success) break ;;
  esac
  [ "$progress" = "100%" ] && break
  polls=$((polls + 1))
  sleep 10
done
if [ "$polls" -ge 54 ]; then
  echo "Video generation did not complete within 9 minutes" >&2
  exit 1
fi

mkdir -p output
output_path="output/${video_id}.mp4"
curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "$output_path"
printf 'Saved: %s (%s bytes)
' "$output_path" "$(wc -c < "$output_path")"

cURL Code Example

response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F prompt='A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080) || exit 1

video_id=$(printf '%s' "$response" | sed -n 's/.*"id"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
if [ -z "$video_id" ]; then
  printf 'Missing video ID: %s\n' "$response" >&2
  exit 1
fi
printf 'Video ID: %s\n' "$video_id"

polls=0
while [ "$polls" -lt 54 ]; do
  status_response=$(curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY") || exit 1
  progress=$(printf '%s' "$status_response" | sed -n 's/.*"progress"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  status=$(printf '%s' "$status_response" | sed -n 's/.*"status"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')
  printf 'Progress: %s, Status: %s\n' "${progress:-0%}" "${status:-unknown}"
  case "$status" in
    FAILURE|failure|failed|error|cancelled|canceled) exit 1 ;;
    completed|succeeded|success) break ;;
  esac
  [ "$progress" = "100%" ] && break
  polls=$((polls + 1))
  sleep 10
done
if [ "$polls" -ge 54 ]; then
  echo "Video generation did not complete within 9 minutes" >&2
  exit 1
fi

mkdir -p output
output_path="output/${video_id}.mp4"
curl -sS --fail-with-body "https://api.cometapi.com/v1/videos/${video_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -o "$output_path"
printf 'Saved: %s (%s bytes)\n' "$output_path" "$(wc -c < "$output_path")"

Python Code Example

import os
import time
from pathlib import Path

import requests

# Get your API key from https://www.cometapi.com/console/token, and paste it here
API_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com".rstrip("/")

response = requests.post(
    f"{BASE_URL}/v1/videos",
    headers={"Authorization": f"Bearer {API_KEY}"},
    files={
        "model": (None, "wan3.0"),
        "prompt": (None, "A small robot walks through a bright greenhouse with smooth camera movement."),
        "seconds": (None, "5"),
        "size": (None, "1920x1080"),
    },
    timeout=120,
)
response.raise_for_status()
video_id = response.json()["id"]
print(f"Video ID: {video_id}")

deadline = time.monotonic() + 540
while time.monotonic() < deadline:
    response = requests.get(
        f"{BASE_URL}/v1/videos/{video_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=120,
    )
    response.raise_for_status()
    result = response.json()
    data = result.get("data") or result
    progress = data.get("progress", result.get("progress", "0%"))
    status = str(data.get("status", result.get("status", "unknown")))
    print(f"Progress: {progress}, Status: {status}")
    if status.lower() in {"failure", "failed", "error", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {result}")
    if progress == "100%" or status.lower() in {"completed", "succeeded", "success"}:
        break
    time.sleep(10)
else:
    raise TimeoutError("Video generation did not complete within 9 minutes")

response = requests.get(
    f"{BASE_URL}/v1/videos/{video_id}/content",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=120,
)
response.raise_for_status()
output_path = Path("output") / f"{video_id}.mp4"
output_path.parent.mkdir(parents=True, exist_ok=True)
output_path.write_bytes(response.content)
print(f"Saved: {output_path} ({output_path.stat().st_size} bytes)")

JavaScript Code Example

import { mkdir, writeFile } from "node:fs/promises";

// Get your API key from https://www.cometapi.com/console/token, and paste it here
const apiKey = process.env["COMETAPI_KEY"] || "<YOUR_COMETAPI_KEY>";
const baseUrl = "https://api.cometapi.com".replace(/\/$/, "");

const form = new FormData();
form.append("model", "wan3.0");
form.append("prompt", "A small robot walks through a bright greenhouse with smooth camera movement.");
form.append("seconds", "5");
form.append("size", "1920x1080");

let response = await fetch(`${baseUrl}/v1/videos`, {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}` },
  body: form,
});
if (!response.ok) throw new Error(await response.text());
const { id: videoId } = await response.json();
console.log(`Video ID: ${videoId}`);

const deadline = Date.now() + 540_000;
let completed = false;
while (Date.now() < deadline) {
  response = await fetch(`${baseUrl}/v1/videos/${videoId}`, {
    headers: { Authorization: `Bearer ${apiKey}` },
  });
  if (!response.ok) throw new Error(await response.text());
  const result = await response.json();
  const data = result.data || result;
  const progress = data.progress || result.progress || "0%";
  const status = String(data.status || result.status || "unknown");
  console.log(`Progress: ${progress}, Status: ${status}`);
  if (["failure", "failed", "error", "cancelled", "canceled"].includes(status.toLowerCase())) {
    throw new Error(`Video generation failed: ${JSON.stringify(result)}`);
  }
  if (progress === "100%" || ["completed", "succeeded", "success"].includes(status.toLowerCase())) {
    completed = true;
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 10_000));
}
if (!completed) throw new Error("Video generation did not complete within 9 minutes");

response = await fetch(`${baseUrl}/v1/videos/${videoId}/content`, {
  headers: { Authorization: `Bearer ${apiKey}` },
});
if (!response.ok) throw new Error(await response.text());
const video = Buffer.from(await response.arrayBuffer());
await mkdir("output", { recursive: true });
const outputPath = `output/${videoId}.mp4`;
await writeFile(outputPath, video);
console.log(`Saved: ${outputPath} (${video.length} bytes)`);