PromptHub 视频反推支持哪些视频格式？

直接答案

PromptHub 视频反推的上传接口放行 MP4、WebM、MOV、AVI、MKV 五种格式。其中 MP4（H.264 编码）兼容性最好，是推荐格式。上传通过不等于分析一定成功：如果分析阶段提示"视频文件无效或无法读取"，说明上游模型无法解析该文件，此时把视频转换为 MP4（H.264）后重新上传通常可以解决。

支持的格式清单

格式	常见扩展名	MIME 类型	建议
MP4	.mp4	video/mp4	推荐首选，兼容性最好
WebM	.webm	video/webm	可用
QuickTime	.mov	video/quicktime	可用，iPhone 常见格式
AVI	.avi	video/x-msvideo	可用，建议先转 MP4
Matroska	.mkv	video/x-matroska	可用，建议先转 MP4

选择文件时，PromptHub 会先校验文件类型和大小；不在上述范围内的格式会被直接拒绝，并提示不支持该视频格式。

为什么推荐 MP4（H.264）

格式（容器）和编码是两件事，这是很多格式问题的根源。

.mp4、.mkv、.mov 是容器，决定文件如何组织；H.264、H.265、VP9、AV1 是编码，决定画面如何压缩。同一个 .mp4 文件，内部编码可能是 H.264，也可能是 H.265。

PromptHub 的上传校验只看容器类型，而后续负责分析的模型对编码有自己的支持范围。这就导致一种情况：文件成功上传，但分析时报告文件无效。实测中 MP4 + H.264 这个组合通过率最稳定，因此作为推荐配置。

如果你的素材是 H.265（HEVC）的 .mp4，或者 .mkv 封装的高规格视频，建议先转码。

格式之外还有哪些因素影响成功率

格式正确但分析失败时，通常是下面这些原因：

• 文件大小超限。 快速分析上限 70MB，精确分析上限 100MB。
• 分辨率过高。 快速分析对超过 1280×720 的视频会先在浏览器压缩到 720p 再上传；页面建议素材控制在 1080p 或以下。
• 文件损坏或未完整下载。 从第三方平台保存的视频有时不完整，本地播放器可能容错播放，但模型无法解析。
• 音轨异常。 反推会完整听写音轨，音轨编码异常可能影响处理。

一个真实的处理例子

素材：iPhone 拍摄的 .mov 文件，1080p，时长 45 秒，大小 86MB。

直接用快速分析会被拦截，因为 86MB 超过快速分析的 70MB 上限。可行路径有两条：

1. 改用精确分析，86MB 在 100MB 上限之内，可直接上传。
2. 用任意转码工具导出为 MP4（H.264）、720p，文件通常会降到 20MB 以内，之后两个模式都可用。

第二条路径同时解决了大小和编码两个问题，更稳妥。

常见失败原因和解决方法

提示"不支持的视频格式"。

文件容器不在五种放行格式内。转换为 MP4 后重试。

上传成功，但分析时提示"视频文件无效或无法读取，请确认视频可以正常播放"。

上游模型无法解析该文件。按顺序尝试：转换为 MP4（H.264）；压缩到 720p；改用精确分析对单个场景分别处理。分析失败的点数会自动退还。

本地能正常播放，为什么还说无效？

本地播放器的容错能力通常强于分析模型，能播放不代表编码受支持。转码是最直接的解决办法。

有哪些限制

• 上传校验只检查容器格式与文件大小，不检查内部编码，因此存在"上传成功但分析失败"的情况。
• 页面上传说明中列出的格式与后端放行范围以实际页面提示为准，功能调整后可能变化。
• 格式合规不保证分析结果质量，画面过暗、快速抖动等素材条件仍会影响准确度。

相关工具

打开 PromptHub 视频反推提示词