Skip to content

Repository files navigation

VIVAGV

VIVAGV 是一个可 Docker 部署的自动化视频生成服务:

  • 接入 OpenAI 兼容接口自动生成“可直接渲染”的视频脚本 JSON
  • 调用第三方 TTS 接口生成配音
  • 使用 Remotion 渲染竖屏 mp4

架构

  • API:接收任务、查询状态
  • Worker:生成脚本 → 配音 → 渲染
  • Redis:任务队列

快速开始(Docker)

  1. 复制配置:
cp .env.example .env
  1. 配置 .env 中的 SCRIPT_API_*TTS_API_*

  2. 启动:

docker compose up --build

API 默认监听 http://localhost:8787

本地运行(可选)

需要本机安装 ffmpeg(用于音频时长与转码)。然后:

npm install
cp .env.example .env
npm run dev:api
npm run dev:worker

API 示例

创建任务:

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.tssrc/providers/script/template.ts

TTS 接口适配

面向基础用户:只需要提供 TTS 接口地址、音色样本路径(本地或 https),其余使用默认值即可。

如需对接不同格式的 TTS 服务,可通过 .env 切换请求与响应模式。

输出文件

默认输出在 output/jobs/<jobId>/output.mp4

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages