视频生成
Elftia 的视频生成功能支持通过文本描述或参考图片使用 AI 生成短视频，集成了多个主流视频生成提供商，采用异步轮询模型处理耗时的视频渲染任务。
使用场景
- 根据文字描述生成短视频素材
- 将静态图片转换为动态视频（图生视频）
- 快速生成创意视频用于社交媒体或演示
- 对比不同提供商的生成效果
支持的提供商
| 提供商 | 特点 | API 类型 |
|---|---|---|
| Kling AI | 高质量视频生成，支持多种分辨率 | 异步 API |
| OpenAI (Sora) | OpenAI 的视频生成模型 | 异步 API |
| Replicate | 开源模型托管平台，模型选择丰富 | 异步 API |
| VolcEngine | 火山引擎视频生成服务 | 异步 API |
| Wan | Wan 视频生成 | 异步 API |
| 自定义（Unified） | 兼容统一接口的第三方服务 | 异步 API |
配置提供商
操作步骤
- 打开 设置 > 媒体提供商 > 视频
- 选择一个提供商
- 输入 API Key（部分提供商还需要 Access Key 或其他认证信息）
- （可选）自定义 API 端点
- 选择默认模型
- 保存并启用
提供商配置表
| 配置项 | 说明 | 是否必填 |
|---|---|---|
| API Key | 提供商的 API 密钥 | 是 |
| API 端点 | 自定义 API 地址 | 否（默认官方地址） |
| 默认模型 | 默认使用的视频模型 | 否 |
| 启用状态 | 是否启用此提供商 | 是 |
生成视频
操作步骤
- 选择视频生成功能
- 选择提供商和模型
- 输入视频描述提示词
- （可选）上传参考图片（图生视频模式）
- 配置生成参数
- 点击 生成
- 等待异步任务完成
生成参数
参数因提供商而异，常见参数包括：
| 参数 | 说明 | 备注 |
|---|---|---|
| 提示词 (Prompt) | 视频内容的文字描述 | 必填 |
| 参考图片 | 作为视频起始帧的图片 | 可选，图生视频模式 |
| 时长 (Duration) | 视频时长（秒） | 取决于提供商 |
| 分辨率 (Resolution) | 视频分辨率 | 如 720p、1080p |
| 帧率 (FPS) | 每秒帧数 | 取决于提供商 |
异步轮询模型
由于视频生成通常需要较长时间（数十秒到数分钟），Elftia 采用异步轮询机制：
发送生成请求 → 获取任务 ID → 定时轮询状态 → 任务完成 → 下载视频
行为说明
- 提交请求 — 向提供商 API 发送生成请求，获得一个任务 ID
- 轮询状态 — 系统自动定期查询任务状态（通常每 5-10 秒一次）
- 任务完成 — 当状态变为完成后，自动下载生成的视频文件
- 结果展示 — 视频在界面中展示并可播放
在等待过程中，界面会显示当前任务状态和预计剩余时间（如提供商支持）。
自动重试
生成过程中遇到临时错误时，系统会自动重试：
| 设置 | 说明 | 默认值 |
|---|---|---|
| 重试次数 | 失败后的最大重试次数 | 2 |
| 重试间隔 | 采用指数退避策略 | 初始 1 秒 |
全局视频设置
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 并发数 | 同时进行的视频生成任务数 | 1 |
| 重试次数 | 生成失败时的自动重试次数 | 2 |
在 设置 > 媒体提供商 > 视频 > 全局设置 中可以调整这些参数。
提供商选择建议
| 需求 | 推荐提供商 |
|---|---|
| 高质量商业级视频 | Kling AI |
| OpenAI 生态整合 | OpenAI (Sora) |
| 开源模型灵活选择 | Replicate |
| 国内网络稳定访问 | VolcEngine |
常见问题
| 问题 | 解决方案 |
|---|---|
| 任务一直在等待中 | 视频生成需要较长时间，请耐心等待。部分高质量模型可能需要数分钟 |
| 生成失败，提示超时 | 提供商可能负载过高，稍后再试 |
| 视频无法播放 | 检查视频格式是否被系统支持，尝试使用外部播放器 |
| API Key 验证失败 | 确认 API Key 正确，且账户有足够的配额 |
| 自定义提供商不兼容 | 确认 API 接口符合统一接口规范（Unified 格式） |