StoryEngine

StoryEngine 是一个故事转视频引擎，提供故事规划、参考素材生成、空间与机位求解、逐镜头生成和评估，以及最终视频组装。

版本：1.2.0 · Python：>= 3.12

StoryEngine/
├── story_engine/              # 核心 Python 源码
├── examples/
│   └── tiny_request.yaml      # 故事与 Provider 配置示例
├── README.md
├── pyproject.toml             # 安装配置、依赖和命令入口
├── uv.lock                    # 锁定的依赖版本
└── .gitignore

需要 Python 3.12 或更高版本、uv、FFmpeg 和 FFprobe，以及可用的文本、图片、视频和评估 Provider。

git clone https://github.com/wwwTaylor/StoryEngine.git
cd StoryEngine
uv sync
uv run story-engine doctor

doctor 检查 FFmpeg 和 FFprobe 是否可用。

复制示例作为本地配置：

cp examples/tiny_request.yaml tiny_request.local.yaml

Windows PowerShell 可使用 Copy-Item examples/tiny_request.yaml tiny_request.local.yaml。

编辑 tiny_request.local.yaml 中的故事、Provider 模型和能力参数，将占位地址 https://your-gateway.example.com 替换为自己的网关。示例使用 OpenAI 兼容接口及 Gemini 原生接口；模型名称、尺寸和时长声明需与实际服务相符。

凭据通过环境变量提供。Bash 使用：

export STORY_ENGINE_GATEWAY_KEY="<your-api-key>"

Windows PowerShell 使用：

$env:STORY_ENGINE_GATEWAY_KEY = "<your-api-key>"

校验配置并运行：

uv run story-engine validate tiny_request.local.yaml
uv run story-engine run tiny_request.local.yaml --run-id my-run

中断后可恢复已有运行：

uv run story-engine resume runs/my-run

默认输出位于 runs/。恢复时仍需提供对应的凭据环境变量。