> ## 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。
* 厂商结果地址通常是临时地址，需要长期使用的视频应转存到项目文件存储。
* 视频密钥只保存在服务端函数中，不能写入浏览器代码、数据库、日志或响应。
* 每次真实创建任务都会消耗算力值，不得用真实生成探测模型、下拉框或接入状态。