VIVAGV 是一个可 Docker 部署的自动化视频生成服务:
- 接入 OpenAI 兼容接口自动生成“可直接渲染”的视频脚本 JSON
- 调用第三方 TTS 接口生成配音
- 使用 Remotion 渲染竖屏 mp4
- API:接收任务、查询状态
- Worker:生成脚本 → 配音 → 渲染
- Redis:任务队列
- 复制配置:
cp .env.example .env-
配置
.env中的SCRIPT_API_*与TTS_API_*。 -
启动:
docker compose up --buildAPI 默认监听 http://localhost:8787。
需要本机安装 ffmpeg(用于音频时长与转码)。然后:
npm install
cp .env.example .env
npm run dev:api
npm run dev:worker创建任务:
curl -X POST http://localhost:8787/v1/jobs \
-H 'Content-Type: application/json' \
-d '{
"productName": "VIVAKB 企业知识库",
"brandName": "VIVA",
"audience": "企业老板",
"tone": "行业化、可信、略有冲劲",
"features": ["私有化部署", "RBAC 权限", "审计追溯", "混合检索"],
"highlights": ["高合规行业可用", "答案有据可查", "效率显著提升"],
"ctaAction": "预约演示",
"ctaUrl": "vivabank.cn",
"brief": "重点强调风控、效率、可落地"
}'查询状态:
curl http://localhost:8787/v1/jobs/<jobId>下载视频:
curl -L http://localhost:8787/v1/jobs/<jobId>/file -o output.mp4默认使用 OpenAI 兼容脚本接口,也可通过 SCRIPT_PROVIDER=template 使用内置模板生成(无需 API Key)。
如需更改文案风格、场景数量、字段格式,请修改 src/providers/script/openai.ts 或 src/providers/script/template.ts。
面向基础用户:只需要提供 TTS 接口地址、音色样本路径(本地或 https),其余使用默认值即可。
如需对接不同格式的 TTS 服务,可通过 .env 切换请求与响应模式。
默认输出在 output/jobs/<jobId>/output.mp4。