Skip to content

5 分钟快速开始

环境要求

项目要求
操作系统Windows 10+ / macOS 12+ / Ubuntu 20.04+
内存≥ 8 GB(推荐 16 GB)
显存≥ 4 GB(用于 Qwen2.5-VL,无则自动用 CPU)
磁盘≥ 5 GB 可用空间

安装

bash
brew install scenefab
scenefab
bash
pip install scenefab
scenefab
bash
git clone https://github.com/Agions/scene-fab.git
cd scene-fab
pip install -e .
scenefab

配置 API Key

SceneFab 需要以下 API Key:

服务用途费用
DeepSeek解说稿生成~¥0.1/百万 tokens
Qwen VL视频帧语义分析¥0.1/千次
Edge TTS配音生成免费

处理一部 2 小时电影解说,成本不足 1 元

获取 API Key

DeepSeek

  1. 访问 platform.deepseek.com → API Keys → Create
  2. 复制 Key 并填入 SceneFab 设置页

阿里云百炼(Qwen VL)

  1. 访问 bailian.console.aliyun.com → API Keys → 创建
  2. 选择 qwen-vl-max 模型

一键配置

在项目根目录创建 .env

bash
DEEPSEEK_API_KEY=sk-xxx...xxxx
DASHSCOPE_API_KEY=sk-xxx...xxxx
TTS_ENGINE=edge-tts
DEFAULT_EMOTION=heal

快速验证

bash
scenefab --version
# 输出: scenefab 3.0.0

下一步

基于 MIT License 开源 · Copyright © 2025-2026 Agions