> ## 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 地址；本地文件应先上传至文件存储。
* 模型服务返回的视频地址通常是临时地址，不能直接作为长期历史记录；应转存到项目文件存储后再提供播放和分享。
* 启用或停用该能力可能会调整项目代码，并消耗项目算力值。