short-video-maker

环境要求

• 已安装 Docker（README 推荐用 Docker 运行，而非 npm）
• Docker 至少分配 3GB 空闲内存
• Windows + WSL2 需在 .wslconfig 或 Docker Desktop 中设置资源上限
• 云部署建议 Ubuntu ≥22.04、≥4GB RAM、≥2 vCPU、≥5GB 存储
• 一个免费的 Pexels API Key（https://www.pexels.com/api/）

安装与启动步骤

1. 1确认 Docker 资源

   服务至少需要 3GB 空闲内存。Windows 用 WSL2 时要在 .wslconfig 或 Docker Desktop 里放开资源限制，否则可能启动失败。

   docker --version

   复制

2. 2申请 Pexels Key

   打开 https://www.pexels.com/api/ 注册并获取免费 API Key，后面作为环境变量 PEXELS_API_KEY 填入，用于拉取背景视频素材。

3. 3编写 compose 文件

   在项目目录新建 docker-compose.yml，使用官方 tiny 镜像，映射 3123 端口，并把生成视频挂载到 ./videos。

   version: "3"
   
   services:
     short-video-maker:
       image: gyoridavid/short-video-maker:latest-tiny
       environment:
         - LOG_LEVEL=debug
         - PEXELS_API_KEY=你的Pexels密钥
       ports:
         - "3123:3123"
       volumes:
         - ./videos:/app/data/videos

   复制

4. 4启动容器

   在 docker-compose.yml 所在目录执行，镜像会自动拉取；首次启动较慢，请等待服务就绪。

   docker compose up -d

   复制

5. 5对接 n8n（可选）

   若与 n8n 或自托管 AI starter kit 共用网络，给该服务加 networks: ['demo']，之后在 n8n 中用 http://short-video-maker:3123 访问。

6. 6取出生成视频

   生成结果会写入容器内 /app/data/videos，由于已做卷映射，直接在宿主机当前目录的 ./videos 里就能拿到成片。

   ls ./videos

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:3123 查看 Web UI，或请求 GET /api/music-tags 能返回音乐标签即表示服务已正常运行。

常见问题

注意事项

• 必须提供 PEXELS_API_KEY，否则无法拉取背景视频素材。
• 本工具不是凭图片或提示词从零生成画面，而是组合 TTS、字幕、背景视频与音乐。
• 标题、字幕位置、音乐情绪、音量、画面方向等属于请求级配置项（如 orientation 默认 portrait、voice 默认 af_heart），在调用接口时传入即可。
• 资源受限时可调小 CONCURRENCY 与 VIDEO_CACHE_SIZE_IN_BYTES。