准备工作 ⚙️

• 第三方 账号注冊及 环境配置 (API Key)
• 必要软件安装

API KEY	描述	模块
OPENAI_API_KEY	不使用OpenAI，无需注册	翻译
GOOGLE_API_KEY	不使用Gemini，无需注册	翻译
DASHSCOPE_API_KEY	不使用Dashscope，无需注册	翻译
HUGGINGFACEHUB_API_TOKEN	不使用多说话人，无需注册	多说话人识别
NGROK_AUTH_TOKEN	不使用内网透传，无需注册	远程部署

账号注冊（第三方）

模型库

Huggingface

申请链接 https://huggingface.co/settings/tokens

注意

需要科学上网

语言模型

OpenAi ChatGpt

申请链接 https://platform.openai.com

推荐指数 🔥🔥🔥🔥🔥 收费没有免费额度

注意

需要科学上网

Google Gemini

申请链接 https://aistudio.google.com/apikey

推荐指数 🔥🔥🔥🔥🔥 免费额度满足日常使用

注意

需要科学上网

DashScope Qwen

申请链接 https://bailian.console.aliyun.com/console?tab=model#/api-key

新人免费开通送100万Tokens

注意

有效期一般是 30 ~ 180 天

辅助

Ngrok 内网透传

申请链接 https://dashboard.ngrok.com/domains

信息

非必须，本地部署则不需要

环境变量

Windows、Linux、MacOS

以下是需要配置的环境变量和相应的 API 密钥。请根据你的需求替换 <OPENAI_API_KEY>、<GOOGLE_API_KEY>、<DASHSCOPE_API_KEY>、<HUGGINGFACEHUB_API_TOKEN> 和 <NGROK_AUTH_TOKEN> 为实际的密钥。

所有信息均存储在本地电脑的环境变量中，程序不会记录保存 apikey 信息

1.右键点击 此电脑 并选择 属性

2.点击 高级系统设置，然后选择 环境变量

3.在 系统变量 部分，点击 新建 并分别添加以下变量：

• OPENAI_API_KEY
• GOOGLE_API_KEY
• DASHSCOPE_API_KEY
• HUGGINGFACEHUB_API_TOKEN
• NGROK_AUTH_TOKEN

4.进入命令提示符或PowerShell，运行以下命令验证：

echo $env:GOOGLE_API_KEY

提示

Colab 使用，见 《远程部署》 章节

依赖软件

多媒体处理 FFmpeg

FFmpeg 是一个功能强大、跨平台的开源命令行工具和开发库，用于处理音视频文件。它可以用来 录制、转换、剪辑、流式传输音视频，支持几乎所有常见的音视频格式

1. 下载安装

前往官网根据操作系统下载 FFmpeg 安装包 https://ffmpeg.org

这里以 Windows 为例

• 解压 ffmpeg-essentials_build.7z 压缩包至 D:\Program Files\FFmpeg 文件夹
• 配置环境变量在 Path 中追加 D:\Program Files\FFmpeg\bin 注销重新登录

2. 验证安装

打开 PowerShell，输入如下命令

ffmpeg -version

正常安装返回结果

ffmpeg version 2025-06-04-git-a4c1a5b084-essentials_build-www.gyan.dev Copyright (c) 2000-2025 the FFmpeg developers
built with gcc 15.1.0 (Rev4, Built by MSYS2 project)
configuration: --enable-gpl --enable-version3 --enable-static --disable-w32threads --disable-autodetect --enable-fontconfig --enable-iconv --enable-gnutls --enable-libxml2 --enable-gmp --enable-bzlib --enable-lzma --enable-zlib --enable-libsrt --enable-libssh --enable-libzmq --enable-avisynth --enable-sdl2 --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxvid --enable-libaom --enable-libopenjpeg --enable-libvpx --enable-mediafoundation --enable-libass --enable-libfreetype --enable-libfribidi --enable-libharfbuzz --enable-libvidstab --enable-libvmaf --enable-libzimg --enable-amf --enable-cuda-llvm --enable-cuvid --enable-dxva2 --enable-d3d11va --enable-d3d12va --enable-ffnvcodec --enable-libvpl --enable-nvdec --enable-nvenc --enable-vaapi --enable-openal --enable-libgme --enable-libopenmpt --enable-libopencore-amrwb --enable-libmp3lame --enable-libtheora --enable-libvo-amrwbenc --enable-libgsm --enable-libopencore-amrnb --enable-libopus --enable-libspeex --enable-libvorbis --enable-librubberband
libavutil      60.  3.100 / 60.  3.100
libavcodec     62.  3.101 / 62.  3.101
libavformat    62.  0.102 / 62.  0.102
libavdevice    62.  0.100 / 62.  0.100
libavfilter    11.  0.100 / 11.  0.100
libswscale      9.  0.100 /  9.  0.100
libswresample   6.  0.100 /  6.  0.100

推荐下载

虚拟环境 Miniconda

Miniconda 是一个可以快速创建干净、隔离的 Python 虚拟环境，适合数据分析、AI 项目、自定义脚本等场景

1. 下载安装

前往官网根据操作系统下载 Miniconda 安装包 https://www.anaconda.com/download/success

这里以 Windows 为例

• 双击 .exe 安装包
• 勾选 “Add Miniconda to PATH”（可选但推荐）
• 完成后在开始菜单搜索 "Anaconda Prompt"

2. 验证安装

# 列出所有虚拟环境
conda env list

正常安装返回结果

PS C:\Users\home> conda env list
# conda environments:
#
base                   D:\Projects\miniconda3

3. 常见命令

命令	说明
conda create --name creatorbox python=3.11.11	创建名为 creatorbox 的环境，指定 Py 版本 3.11.11
conda env list	列出所有已创建的虚拟环境
conda activate creatorbox	激活进入名为 creatorbox 的环境
conda deactivate	退出当前激活的环境
conda remove -n creatorbox --all	删除名为 creatorbox 的整个环境

注意

推荐使用 Miniconda 而非 Anaconda，体积更小、启动更快、依赖更纯粹

版本控制 Git

Git 是一个分布式版本控制系统，可以帮助开发人员跟踪代码更改、与他人协作以及高效管理软件项目

1. 下载安装

前往官网根据操作系统下载 Git 安装包 https://git-scm.com

这里以 Windows 为例

• 双击 .exe 安装包
• 安装时推荐保留默认选项

2. 验证安装

桌面右键选择 Git Bash Here，输入如下命令

git --version

正常安装返回结果

git version 2.47.0.windows.2

3. 常见命令

命令	说明
git clone <仓库地址>	克隆下载指定仓库地址文件
git pull	拉取最新内容

注意

• 1、git clone 克隆最好不要有空格、中文，避免一些奇葩问题

• 2、git pull 进入克隆下载的 CreatorBox文件夹，运行此命令，可以直接更新代码

视频剪辑 JianYing

剪映是一款全能易用的桌面端剪辑软件，让创作更简单

1. 下载安装

前往官网根据操作系统下载 Git 安装包 https://www.capcut.cn

这里以 Windows 为例

• 双击 .exe 安装包
• 安装时根据需要设置选项

注意

• 1、默认 导出草稿 不区分版本

• 2、如使用 剪映素材提取 则需要下载5.9及以下版本