Wan 影片生成
透過 AceDataCloud 的 Wan(阿里雲)API 生成 AI 影片。
設定: 請參閱 驗證 了解 Token 設定方法。
快速開始
curl -X POST https://api.acedata.cloud/wan/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "a dolphin jumping through ocean waves at golden hour", "model": "wan2.6-t2v"}'
非同步處理: 請參閱 非同步任務輪詢。透過
POST /wan/tasks搭配{"id": "..."}進行輪詢。
模型
| 模型 | 類型 | 最佳用途 |
|---|---|---|
wan2.6-t2v | 文字轉影片 | 根據文字描述建立影片 |
wan2.6-i2v | 圖片轉影片 | 將靜態圖片動畫化為影片 |
wan2.6-r2v | 參考影片轉影片 | 從參考影片中提取角色並進行遷移 |
wan2.6-i2v-flash | 圖片轉影片(快速) | 快速生成圖片轉影片 |
工作流程
1. 文字轉影片
POST /wan/videos
{
"action": "text2video",
"prompt": "a time-lapse of flowers blooming in a meadow",
"model": "wan2.6-t2v",
"resolution": "720P",
"duration": 5
}
2. 圖片轉影片
將靜態圖片動畫化為影片片段。
POST /wan/videos
{
"action": "image2video",
"prompt": "gentle wind blows through the scene",
"model": "wan2.6-i2v",
"image_url": "https://example.com/landscape.jpg",
"resolution": "720P",
"duration": 5
}
3. 圖片轉影片(快速)
以較低延遲更快地生成圖片轉影片。
POST /wan/videos
{
"action": "image2video",
"prompt": "camera slowly pans across the landscape",
"model": "wan2.6-i2v-flash",
"image_url": "https://example.com/scene.jpg"
}
4. 參考影片遷移
從參考影片中提取角色或音色,並遷移至新的生成內容中。
POST /wan/videos
{
"action": "text2video",
"prompt": "the character walks through a futuristic city at night",
"model": "wan2.6-r2v",
"reference_video_urls": ["https://example.com/reference.mp4"]
}
5. 多鏡頭剪輯
生成包含多個鏡頭的影片,而非單一連續拍攝。
POST /wan/videos
{
"action": "text2video",
"prompt": "a chef preparing a meal in a busy kitchen",
"model": "wan2.6-t2v",
"shot_type": "multi",
"duration": 10
}
6. 影片含音訊
在生成影片的同時啟用音訊生成。
POST /wan/videos
{
"action": "text2video",
"prompt": "ocean waves crashing on a rocky shore",
"model": "wan2.6-t2v",
"audio": true
}
參數
| 參數 | 必填 | 值 | 說明 |
|---|---|---|---|
action | 是 | "text2video", "image2video" | 操作類型 |
prompt | 是 | 字串 | 場景描述 |
model | 是 | "wan2.6-t2v", "wan2.6-i2v", "wan2.6-r2v", "wan2.6-i2v-flash" | 模型 |
image_url | 圖片轉影片時必填 | 字串 | 來源圖片 URL(圖片轉影片時必填) |
negative_prompt | 否 | 字串(最多 500 字元) | 要排除的內容 |
reference_video_urls | r2v 時必填 | 字串陣列 | 用於角色/音色提取的參考影片 |
shot_type | 否 | "single", "multi" | 連續鏡頭或多鏡頭剪輯 |
audio | 否 | 布林值 | 在生成的影片中啟用音訊 |
audio_url | 否 | 字串 | 參考音訊 URL |
resolution | 否 | "480P", "720P", "1080P" | 輸出解析度(預設:720P) |
size | 否 | 字串 | 生成影片的大小 |
duration | 否 | 5, 10, 15 | 影片長度(秒) |
prompt_extend | 否 | 布林值 | 啟用基於 LLM 的提示詞重寫 |
callback_url | 否 | 字串 | 非同步 Webhook 通知 URL |
注意事項
image_url在用於wan2.6-i2v和wan2.6-i2v-flash模型時為必填reference_video_urls僅在用於wan2.6-r2v時進行角色/音色遷移negative_prompt的最大長度為 500 字元- 支援的長度僅為 5、10 或 15 秒
- 預設解析度為 720P;使用 1080P 可獲得更高品質,但成本也會增加
shot_type: "multi"會產生多鏡頭剪輯而非單一連續拍攝
MCP:
pip install mcp-wan| 託管版本:https://wan.mcp.acedata.cloud/mcp| 請參閱 所有 MCP 伺服器