> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 影片生成整合

> 接入 Seedance 非同步提交、輪詢、異常處理和影片持久化工作流。

# AI 影片生成整合

AI 影片生成整合用於在產品中構建完整的影片生成能力：覆蓋任務提交、狀態輪詢、失敗處理、結果持久化和前端播放展示。適合行銷素材、商品展示、內容創作，以及文生影片、圖生影片等場景。

***

## 能做什麼

* 支援文生影片，以及基於參考圖片的圖生影片。
* 建立並追蹤非同步生成任務，避免重複提交和重複處理。
* 處理模型服務異常、額度限制等情況，並支援重試。
* 將生成結果轉存至專案檔案儲存，提供可長期使用的播放與分享連結。
* 在前端展示排隊中、生成中、成功和失敗等狀態。

<Note>
  影片生成、雲計算和檔案儲存等底層能力會由 superun 按需準備。你通常不需要單獨理解這些依賴。
</Note>

***

## 接入前需要準備

| 準備項      | 說明                                      |
| -------- | --------------------------------------- |
| 生成方式     | 明確需要文生影片、圖生影片，或兩者都要                     |
| 生成參數     | 準備模型、時長、畫面比例等產品側參數要求                    |
| 參考圖（如需要） | 圖生影片的參考圖需為可公開訪問的 HTTPS 地址；本機檔案請先上傳到檔案儲存 |
| 歷史記錄需求   | 是否需要保存生成歷史，便於使用者回看和分享                   |

***

## 如何在 superun 中啟用

<Steps>
  <Step title="點擊右上角「使用」">
    在技能庫中打開「AI 影片生成整合」，點擊右上角「使用」，讓 superun 開始接入。
  </Step>

  <Step title="明確生成參數">
    說明文生 / 圖生、模型、時長、畫面比例，以及是否保存生成歷史。
  </Step>

  <Step title="驗證生成與播放">
    提交測試任務，確認狀態展示正常；完成後可在專案儲存中播放持久化影片。
  </Step>
</Steps>

***

## 使用限制

* 影片生成是非同步過程，通常需要約 30 秒至數分鐘，請在介面中展示清晰狀態，避免使用者重複發起。
* 圖生影片的參考圖片必須是可公開訪問的 HTTPS 地址；本機檔案應先上傳至檔案儲存。
* 模型服務返回的影片地址通常是臨時地址，不能直接作為長期歷史記錄；應轉存到專案檔案儲存後再提供播放和分享。
* 啟用或停用該能力可能會調整專案程式碼，並消耗專案算力值。