音视频格式与排障

编辑端导入音视频、字幕与图片时会校验文件格式、体积与时长上限。格式不符或超出上限的文件，转换格式、切分或压缩后即可重新导入。

上传文件规格

素材类型	格式与说明	体积上限	时长上限
本地视频	仅支持 .mp4	200 MB	2 小时
B 站 / 抖音链接视频	单集公开视频链接，B 站最高抓取 720P	下载后 200 MB	—
音频 / 歌曲	.mp3、.wav、.aac、.m4a	25 MB	30 分钟
外挂字幕	.srt、.vtt、.lrc，自动兼容 UTF-8 与 GBK 编码	5 MB	—
看图学词底图	单张底图上传	3 MB	—
课程包封面	JPG、PNG、WebP、GIF，超过 1 MB 的静态图自动压缩	—	—

本地视频无法上传或播放黑屏

编辑端本地视频仅支持 .mp4 格式。手头若是 .mov、.mkv 等格式的视频，用剪映、HandBrake 或格式工厂导出为 .mp4 文件后再上传即可。

如果视频已经上传成功，但在学习端打开时只有声音、画面黑屏（或不同电脑表现不一），通常是因为原视频使用了 H.265（HEVC） 或 AV1 编码。微信与视频号保存的视频、iPhone 拍摄的视频，以及剪辑软件选了 HEVC 预设导出的 .mp4 常为此类编码，在 Firefox 或未安装解码扩展的 Chrome、Edge 中无法正常解码画面。

按下面步骤转成网页通用的 H.264（AVC）+ AAC 编码重新上传，时长与外挂字幕时间轴不受影响：

用剪映、HandBrake 或格式工厂打开原视频。
导出设置中将容器格式选为 MP4，视频编码选为 H.264（AVC）（不要选 HEVC / H.265），音频编码选为 AAC。
导出新文件后，回到编辑端重新上传。

文件体积或时长超限

音视频体积或时长超出上限无法上传时，可以用下面任一方式处理：

用剪辑工具按章节或自然段把文件切分为多段，分别建成多节课程。
导出时适当调低分辨率与码率，例如将视频分辨率设为 720P。

粘贴 B 站 / 抖音链接导入失败

在编辑端通过 创建课程 → 从 URL 导入 粘贴 B 站或抖音链接后，有时会提示链接无法识别，或课程包页的任务卡片红字提示无法下载。这通常与链接格式、200 MB 体积上限、B 站登录权限或临时下载失败有关，可对照下方规则与提示处理。

B 站支持 bilibili.com/video/ 链接、BV 号、av 号和 b23.tv 短链；抖音支持 douyin.com/video/、iesdouyin.com/video/ 视频链接和 v.douyin.com 短链。链接夹在分享文案里也能识别，格式不符时会提示「无法识别为 B站/抖音视频链接」。
B 站和抖音公开视频可直接导入；B 站需要登录或更高清晰度的视频，可安装句乐部插件后导入。

提交链接后如果导入失败，可对照任务卡片上的失败提示处理：

失败提示	处理办法
「B站视频文件过大，当前版本最多支持 200MB。请换一个更短或更小的视频。」或「抖音视频文件过大，当前版本最多支持 200MB。请换一个更短或更小的视频。」	视频超出体积上限且无法重试，请换一个更短或更小的视频。
「这个 B站视频需要登录状态或权限。请确认浏览器已登录 B站，并通过小句子插件重试。」或「B站视频导入失败，请通过小句子插件重新导入。」	提示里的「小句子插件」就是句乐部插件。安装它（可在从 URL 导入页签点击查看安装教程），确认浏览器已登录 B 站后通过插件重新导入。
「B站视频下载暂时失败，请点击重试或稍后再试。」、「B站视频下载后暂时没有生成可播放的视频文件，请点击重试或稍后再试。」或「抖音暂时无法下载，可能是触发了风控，请稍后重试。」	在任务卡片上点击重试，或稍后再试。
「暂不支持抖音图文笔记，仅支持视频链接导入。」或「该抖音视频为非公开内容（私密/仅粉丝可见）或已删除，暂不支持导入。」	图文笔记、非公开或已删除的视频无法导入，请改用公开的单集视频链接。