> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AI 影片生成整合
> 為產品接入多模型影片生成、Seedance 2.5 多模態與人像流程、非同步任務和結果持久化。
# AI 影片生成整合
該技能會在產品中構建完整的影片生成流程，包括模型選擇、參考素材上傳、任務提交、狀態輪詢、異常處理、結果持久化和前端播放。支援文生影片、圖生影片、多模態參考、原生聲音和授權真人肖像場景。
***
## 能做什麼
* 根據文字、單張或多張圖片，以及圖片/影片/音訊混合素材生成影片。
* 使用 Seedance 2.5 生成同步聲音、虛擬人口播和授權真人肖像影片。
* 選擇目前開放的 Seedance、海螺、可靈和通義萬相模型。
* 建立具備冪等保護的非同步任務，展示排隊、生成、完成和失敗狀態。
* 把廠商臨時結果轉存到專案檔案儲存，供長期播放和分享。
啟用該能力時，superun 會自動準備雲計算和檔案儲存依賴，並把調用憑證配置在專案服務端。你不需要單獨申請廠商 API Key。
***
## 目前模型能力
| 模型 | 平台目前時長 | 參考素材與主要能力 |
| - | - | - |
| 豆包 Seedance 2.0 Fast | 4～15 秒或自動 | 最多 9 張圖片，適合快速預覽，最高 720p |
| 豆包 Seedance 2.0 | 4～15 秒或自動 | 最多 9 張圖片，品質與穩定性均衡，最高 1080p |
| 豆包 Seedance 2.0 Mini | 4～15 秒或自動 | 最多 9 張圖片、3 段影片、3 段音訊，最高 720p |
| 豆包 Seedance 2.5 | 2～30 秒或自動 | 最多 30 張圖片、10 段影片、10 段音訊；支援原生聲音和授權真人影片，最高 1080p |
| 海螺 H3 | 以產品內選項為準 | 最多 1 張圖片，擅長電影感和風格化創作 |
| 可靈 3.0 / 專業版 | 以產品內選項為準 | 最多 1 張圖片，適合人物運動和複雜場景 |
| 通義萬相 2.7 | 以產品內選項為準 | 最多 1 張圖片，適合通用文生影片和圖生影片 |
Seedance 2.0 Mini 的素材總數最多為 12 個，音訊不能作為唯一參考；Seedance 2.5 的素材總數最多為 50 個，並允許僅使用音訊參考。最終開放模型和服務端准入規則以產品執行時配置為準。
***
## 接入前需要準備
| 準備項 | 說明 |
| - | - |
| 生成方式 | 文生、圖生或多模態參考影片 |
| 生成參數 | 模型、時長、畫面比例、解析度和聲音選項 |
| 參考素材 | 服務端可存取的 HTTPS 圖片、影片或音訊；本機檔案先上傳到專案儲存 |
| 人物類型 | 明確真人或虛擬人物；真人必須確認合法的肖像和聲音使用權限 |
| 歷史記錄 | 是否需要長期保留生成結果 |
***
## 如何在 superun 中啟用
在技能庫中打開「AI 影片生成整合」，點擊右上角 **「使用」**。
說明模型、輸入素材、時長、畫面比例、聲音和歷史記錄要求。
先檢查參數校驗、載入、輪詢、錯誤提示和儲存流程；只有使用者明確操作時才建立真實付費任務。
***
## 必須遵守的限制
* 影片生成是非同步過程，通常需要約 30 秒至數分鐘。建立重試必須重用同一個冪等鍵，避免重複付費任務。
* 瀏覽器本機路徑和 `blob:` 地址不能作為廠商輸入；本機素材先上傳到專案儲存，再提交服務端可存取的 HTTPS 地址。
* 切換模型後必須清除新模型不支援的時長、解析度、聲音和參考素材參數。
* Seedance 2.5 真人請求必須且只能使用一張 HTTPS 人像，並由使用者明確確認合法使用權限。平台在服務端完成私有素材匯入，應用不得保存或展示廠商素材 ID。
* 廠商結果地址通常是臨時地址，需要長期使用的影片應轉存到專案檔案儲存。
* 影片密鑰只保存在服務端函式中，不能寫入瀏覽器程式碼、資料庫、日誌或回應。
* 每次真實建立任務都會消耗算力值，不得用真實生成探測模型、下拉選單或接入狀態。