> ⚠️ 重要说明：新版仓库不再开放完整源码，只提供预编译 Docker 镜像 + docker-compose.yaml，部署直接拉取官方镜像，不需要本地 npm 编译；它本身只是调度工作台，不自带任何视频 / 大模型，全部依赖外部 API（可灵、海螺、Vidu、通义万相等）GitHub
硬件要求：普通 PC 即可，不需要高性能显卡；只需要网络能够访问各家 API 接口。

一、前置环境准备

  • Windows：安装 Docker Desktop，开启 WSL2 虚拟化（BIOS 打开 CPU 虚拟化）
  • Linux / NAS：安装 docker + docker-compose-plugin
  • 安装 Git（用来拉取项目 yaml 文件）

    • > Windows 如果不想装 Git，可以手动新建文件夹，下载docker-compose.yaml保存进去。

    二、一键部署步骤（官方推荐）

  • 打开终端（Windows PowerShell / CMD / Linux 终端），克隆仓库

    • git clone https://github.com/shuyu-labs/BigBanana-AI-Director.git
cd BigBanana-AI-Director

  • 启动容器（首次会自动拉取阿里云镜像，国内速度尚可）

    • docker-compose up -d
    > -d 后台守护运行，关闭终端服务不停止

  • 等待镜像下载完成，浏览器访问：

    • http://localhost:3005

  • 查看日志（排查报错）

    • docker-compose logs -f

  • 停止服务

    • docker-compose down
    > 数据：项目素材默认保存在浏览器本地存储，不是存在容器卷里！换浏览器 / 清缓存会丢失项目，重要项目记得导出工程备份GitHub

  • 更新版本

    • docker-compose pull
docker-compose up -d --force-recreate

    三、备选：源码开发模式（仅旧版，不推荐量产）

    > 适合开发调试，不适合稳定批量生产
    git clone https://github.com/shuyu-labs/BigBanana-AI-Director.git
cd BigBanana-AI-Director
npm install
npm run dev

    访问：http://localhost:3000

    > 需要 Node.js 20 环境，依赖安装容易失败，批量短剧生产不要用这个模式GitHub

    四、核心配置：接入多家 API（重点，对口型 / 视频生成）

    BigBanana 原生支持 AntSK 代理，也可以直接配置各家 API Key：

  • 打开 WebUI → 设置页面，填入 API 信息
    • - LLM 剧本：通义千问 / DeepSeek 用来生成剧本、拆分台词 - 生图：通义万相 / Vidu 角色定妆、场景图 - 视频 + 对口型：海螺 H3（对白口型首选）、可灵 Kling、通义万相 S2V
  • 路由策略（直接在 BigBanana 内配置）
    • - 对白特写镜头 → 海螺 H3（音频驱动生成，对口型强） - 二次元漫剧 → Vidu - 真人动作镜头 → 可灵 - 静态场景旁白 → 通义万相（低成本）

    > 原理：BigBanana 负责：剧本拆分、角色资产库、关键帧管理、批量任务队列；音频 TTS、图像、视频、对口型全部转发给对应 API 服务商。

    五、常见坑点（批量制作必看）

  • 端口 3005 被占用
    • 修改docker-compose.yaml，把"3005:80"改成"3006:80"，再重启docker-compose up -d
  • 镜像拉取超时
    • 镜像地址是阿里云国内镜像，如果下载慢，更换 Docker 国内镜像源。
  • 项目数据丢失风险！

    • > 重点：公开版 BigBanana 项目数据存储在浏览器 LocalStorage，不是持久化在服务器磁盘。
    ✅ 解决方案：每做完一集，导出工程 JSON 备份；多人协作 / 长期批量生产，可以修改 yaml 挂载本地持久卷，或者搭配 AntSK 做后端存储。

  • API 调用失败
    • 排查顺序：网络连通性 → API Key 余额 → 模型权限 → 提示词 / 镜头参数是否超出服务商限制。
  • 不能直接全局一键刷新全剧镜头
    • BigBanana 资产绑定能力是调度层，原生没有纳米大片那种全局一键刷新；需要你写简单脚本批量重跑关联镜头。

    六、部署完成后的短剧工作流（对应之前对口型方案）

    Phase01：导入小说 / 剧本，大模型自动拆分分集、台词 

    Phase02：创建角色资产库，上传角色三视图，生成角色定妆图 

    Phase03：分镜编排，设置镜头类型（对白 / 动作 / 静态），系统按路由规则调用 API：

    • 对白镜头：TTS 生成配音音频 + 调用海螺 H3 音频驱动生成带对口型视频
    Phase04：批量任务排队生成，自动合并片段、字幕，导出成片 MP4

    推荐，走 AntSK 中转，就按上面操作

  • 先部署 AntSK 服务
  • AntSK 后台添加：火山方舟、MiniMax 海螺、可灵、Vidu、通义万相，录入各家服务商 API Key
  • 在 AntSK 创建一个全局 API Key
  • 回到你截图这个 BigBanana 界面 →【全局配置】，把 AntSK 的全局 Key 填入输入框，点验证保存
  • 切换到【对话 / 图片 / 视频 / 配音】标签，下拉选择 AntSK 里已经配置好的模型名称
  • 保存，完成模型配置。BigBanana 所有请求转发给 AntSK，AntSK 再转发给火山方舟 / 海螺 / 可灵等。

    • AntSK 本地部署教程（Docker Compose 极简版，适配 BigBanana 短剧流水线）

    > AntSK 作用：统一网关，聚合火山方舟、MiniMax 海螺、可灵、Vidu、通义万相所有 API，对外只暴露一个统一 API 地址 + 一个全局 Key，给 BigBanana 调用。
    ✅ 环境前提：你的电脑已经装好 Docker Desktop（Windows）/ Docker+Docker Compose（Linux），和部署 BigBanana 是同一台机器。
    ✅ 硬件：不需要显卡！ AntSK 只是 API 转发网关，纯 CPU 即可，8G 内存足够。

    一、拉取项目

    打开 PowerShell / 终端，新建一个文件夹，克隆仓库

    git clone https://github.com/shuyu-labs/AntSK.git
cd AntSK
    > 仓库是 shuyu-labs/AntSK，和 BigBanana 同一个作者，原生适配！

    二、启动（推荐简易版 sqlite，不用装数据库）

    仓库里有 docker-compose.simple.yml（简易版本，SQLite 单文件存储，最适合咱们短剧场景，不用 Postgres、Redis）

    docker-compose -f docker-compose.simple.yml up -d
    • -d 后台常驻运行，关闭终端不停止服务
    • 首次执行自动拉取镜像，国内阿里云镜像，速度尚可

    查看日志（排错用）

    docker-compose -f docker-compose.simple.yml logs -f

    停止服务

    docker-compose -f docker-compose.simple.yml down
    > 数据持久化：sqlite 数据库文件保存在本地目录，容器删除数据不会丢（这点和 BigBanana 不一样！）

    三、访问 AntSK 后台

    浏览器打开：

    http://localhost:5000

  • 首次打开注册管理员账号密码（记住，登录后台用）
  • 登录后台，进入【模型管理】，开始添加各家服务商 API

    • 四、【核心步骤】添加服务商（直接抄，适配短剧流水线）

    > 后台 → 模型管理 → 添加模型提供商

    1. 火山方舟（Seedance + 豆包 LLM + 豆包 TTS）

    • 服务商名称：火山方舟
    • BaseURL：https://ark.cn-beijing.volces.com/api/v3
    • API Key：你的火山方舟 ARK_API_KEY
    > 模型列表：
    >
    - 豆包 Pro（LLM 剧本拆分，填入你的方舟 Endpoint ID）
    - Seedance 2.5（视频生成，对口型，填入方舟 Seedance 的 Endpoint ID）
    - 豆包 TTS（配音）

    2. MiniMax（海螺 H3，对白特写对口型首选）

    • 服务商名称：MiniMax
    • BaseURL：https://api.minimax.com/v1
    • API Key：MiniMax API Key
    • 模型：MiniMax-H3（海螺 H3 音频驱动视频）

    3. 可灵 Kling

    • BaseURL：https://api.klingai.com/v1
    • API Key：可灵 API Key
    • 模型：kling-video

    4. Vidu（二次元漫剧）

    • BaseURL：https://api.vidu.cn/v1
    • API Key：Vidu 密钥

    5. 通义万相（阿里百炼）

    • BaseURL：https://dashscope.aliyuncs.com/compatible-mode/v1
    • API Key：阿里百炼 API Key
    • 模型：万相生图、万相 S2V 视频
    > 每添加一个服务商，点【测试连通性】，显示成功就代表密钥和地址没问题。

    五、创建全局 API Key（给 BigBanana 用！重点）

    后台进入【API 密钥管理】→【新建密钥】

    • 名称：BigBanana-Gateway-Key
    • 权限：全部模型权限
    • 创建后复制这个密钥，就是你 BigBanana 模型配置页面【全局 API KEY】输入框里粘贴的值！

    六、回到 BigBanana 完成对接

  • 打开 BigBanana 模型配置页面，【全局配置】标签
  • 把上面 AntSK 生成的全局密钥粘贴进去
  • 点击【验证并保存】，提示成功
  • 切换到【对话模型 / 图片模型 / 视频模型 / 配音模型】，下拉框就可以选择 AntSK 后台添加好的火山方舟、海螺、可灵等模型。

    • 七、网络关键注意点（Windows Docker Desktop）

    > BigBanana 容器地址：http://bigbanana:3005
    AntSK 容器地址：http://antsk:5000
    如果 BigBanana 无法访问 AntSK：
    >
    - 方案 1：BigBanana 填写宿主机 IP：http://host.docker.internal:5000（Windows Docker 推荐）
    - 方案 2：两个容器放到同一个 docker 网络。

    八、常见坑点

  • 镜像拉取失败：Docker Desktop 配置国内镜像源
  • 添加火山方舟模型测试报错 401：检查火山方舟的 API Key，以及模型填写的是 Endpoint ID，不是模型名字
  • Seedance 调用失败：AntSK 新版本才支持火山方舟 Seedance 异步视频任务；拉最新 AntSK 镜像
  • BigBanana 验证密钥失败：确认 AntSK 服务正常运行，宿主机 5000 端口没有被防火墙拦截；确认 AntSK 全局密钥没有复制空格
  • 端口 5000 冲突：修改docker-compose.simple.yml端口映射，把5000:80改成5001:80，重启容器，访问地址变成http://localhost:5001

    • 九、整套链路回顾（BigBanana + AntSK）

    BigBanana（Docker） → 请求转发给 AntSK网关（localhost:5000）
AntSK根据模型名称，转发请求到对应服务商：
  海螺H3 → MiniMax官方API（对白对口型）
  Seedance → 火山方舟（漫剧对话）
  可灵 → 快手可灵（真人动作镜头）
  Vidu → 生数科技（二次元漫剧）
  通义万相 → 阿里百炼（低成本空镜）

    十、可选：AntSK 升级 / 备份

    升级 AntSK：

    docker-compose -f docker-compose.simple.yml pull
docker-compose -f docker-compose.simple.yml up -d --force-recreate

    备份：直接复制 AntSK 目录下的antsk.db（sqlite 数据库文件），所有服务商密钥、API Key 全部保存在这里。