SuperAPI AI 工具集

tella-to-youtube

通用与其它

查看项目

更新于 10-19 20:46

技能介绍

用途

tella-to-youtube 是一个极简的 Tella → YouTube 发布流水线,只做三件事:抓取 Tella 上最新的录制视频、根据转录文本生成标题与描述、以 4K 上传到 YouTube。所有 Tella 与 YouTube 操作都经由同一个 CLI:scripts/tella2yt.py(下文简称 tella2yt)。

首次配置

首次真实上传前需要 Tella API Key 与 Google OAuth 凭据。可通过以下命令检查配置状态:

python3 scripts/tella2yt.py doctor

如果 TELLA_API_KEY、client_secrets.json 或 youtube.token 显示缺失,有两种配置方式:让 CLI 驱动交互式向导 python3 scripts/tella2yt.py setup(安装依赖、保存 Tella Key、复制 Google client_secrets.json 并运行浏览器 OAuth 流程);或自行收集 Tella API Key 和 client_secrets.json 路径后逐步执行。配置存放于 ~/.config/tella-to-youtube/(已 git 忽略,权限 600)。配置为一次性操作,doctor 检查通过后即可直接进入工作流。

主要能力与使用方式

1. 从 Tella 抓取

获取最新视频与转录:

python3 scripts/tella2yt.py tella latest          # 最新视频(名称、ID、时长、章节)
python3 scripts/tella2yt.py tella list --limit 5  # 选择其它视频
python3 scripts/tella2yt.py tella transcript <VIDEO_ID>

tella info <VIDEO_ID> 还会输出 Tella 自动生成的章节,可在后续转为 YouTube 时间戳。

导出并下载 4K 母版:

python3 scripts/tella2yt.py tella export <VIDEO_ID> --resolution 4k --download
python3 scripts/tella2yt.py tella download <VIDEO_ID>

每次录制单独存放在 ~/Documents/tella-vids/<video-slug>/(可用 TELLA2YT_DOWNLOAD_DIR 覆盖),合成母版为 <slug>-master.mp4。

2. 可选:拆分摄像头与屏幕轨道

python3 scripts/tella2yt.py tella split <VIDEO_ID>

按类型拼接各源轨道,输出 <slug>-camera.mp4 与 <slug>-screen.mp4,不进行任何上传。需要 ffmpeg。仅在用户要求分离素材时运行。

3. 可选:Auphonic 音频增强

python3 scripts/tella2yt.py audio enhance "[MASTER_MP4_PATH]"

提取音频处理后无视频重编码地重新封装,输出 <name>-master-enhanced.mp4。需要 ffmpeg、AUPHONIC_API_KEY 和 AUPHONIC_PRESET(用户在 Auphonic 中创建的预设 UUID)。若未设置预设,需先在 Auphonic 创建。

4. 生成标题与描述

基于完整转录(加上 Tella 章节和用户指定的角度)生成。标题长度建议 50–60 字符(上限 70,YouTube 硬上限 100),主关键词在前 5 个词内,格式为 [Keyword Hook] — [Engaging Qualifier],可加 1–2 个表情,避免全大写、标题党和以品牌名开头。描述控制在 2–3 段短文,主关键词在前 25 词内,前两行为钩子,时间戳从 0:00 开始,末尾 3–5 个话题标签。上传前校验标题 <100 字符、描述 <5,000 字符、标签各 <500 字符且合计 <500 字符,超限时截断并提示。

5. 可选:生成缩略图

python3 scripts/tella2yt.py thumbnail --title "[CHOSEN_TITLE]" --style "..." --subject "..." --output "[VIDEO_FOLDER]/thumbnail.png" --crop-16x9

使用 OpenAI gpt-image 生成 16:9 单图,需要 OPENAI_API_KEY。提示词刻意不包含文字,需用户后期叠加文字。自定义缩略图要求 YouTube 频道完成手机验证;若 API 拒绝(403),需在 Studio 手动添加。

6. 上传到 YouTube

将标题与描述写入元数据 JSON 后上传:

python3 scripts/tella2yt.py youtube upload "[VIDEO_FILE_PATH]" --meta /tmp/tella2yt-meta.json --meta-out /tmp/tella2yt-result.json

若生成缩略图,追加 --thumbnail 参数。若执行了音频增强,使用 -enhanced.mp4 作为上传文件。YouTube 自动生成字幕,无需上传 SRT。privacyStatus 默认 public,可改为 unlisted 或 private 先审阅。命令会输出视频 ID、公开 URL 和 Studio 链接。

适用场景

适合已有 Tella 录制素材、希望快速完成标题描述生成并上传 YouTube 的创作者,尤其是需要 4K 母版、章节时间戳和可选音频增强的教程或技术类视频。

限制

需预先配置 Tella API Key 与 Google OAuth。依赖 Python 与 Google API 库。4K 导出文件较大(1–4 GB),上传采用断点续传与 5 次指数退避重试。缩略图、音频增强和轨道拆分均为可选步骤,仅在用户要求时运行。不包含 A/B 测试、云盘归档或分发功能;完整流水线另有 upload-to-my-youtube 技能。默认分类 ID 28 为科学与技术,可按内容调整。