必须调用querytexttovideotask接口轮询jobid,待status为“finished”后提取result→videoinfo→url字段获取有效视频直链;app和网页版均不直接提供该地址,需手动抓包或通过api获取。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

腾讯混元文生视频生成成功后,系统不会自动弹出下载链接或直接显示可访问的视频地址,必须通过调用查询接口主动拉取最终生成结果中的视频 URL 才能获取有效播放地址。
通过 JobId 查询任务状态并提取 video_url
第一步:确认你已成功调用 SubmitTextToVideoTask 接口并获得返回的 【JobId】 字符串(形如 “job-xxxxx”),该值是后续所有操作的唯一凭证,丢失即无法定位任务结果。
第二步:调用 QueryTextToVideoTask 接口,传入上一步拿到的 JobId。注意该接口为轮询必需项,单次请求仅返回当前状态,需自行控制重试逻辑(建议间隔 3~5 秒,最多轮询 120 次)。
第三步:当返回字段 Status 变为 “FINISHED” 时,检查 Response 中的 Result → VideoInfo → Url 字段——这就是你要的直链地址,格式为 HTTPS 开头、带临时鉴权参数的完整 URL,有效期通常为 24 小时。
⚠️ 若 Url 字段为空或返回 “WAITING”/“PROCESSING”/“FAILED”,说明任务尚未完成或已失败,不可跳过状态校验直接使用。
在腾讯元宝 App 内查看并复制视频地址
方法一:打开腾讯元宝 App → 进入「AI 视频」功能页 → 点击右上角「历史记录」图标 → 找到对应任务 → 向左滑动该条目 → 点击「复制链接」按钮,粘贴后即可获得分享用短链(该链接跳转后仍指向混元视频服务托管页,非原始 video_url)。
方法二:长按历史记录中的视频缩略图 → 在弹出菜单中选择「保存到相册」→ 视频将下载至手机本地,但此方式不提供可嵌入网页的 URL 地址。
注意:App 内不开放原始 video_url 的查看权限,所有分享链接均为腾讯云 CDN 域名下的中间跳转页,无法用于程序化调用或嵌入 iframe。
从网页版体验平台手动提取真实地址
① 登录 https://video.hunyuan.tencent.com/(需审核通过)→ 进入「我的创作」→ 找到目标视频卡片。
② 点击视频右下角「…」更多按钮 → 选择「分享」→ 弹窗中点击「复制链接」得到的是页面 URL,不是视频文件地址。
③ 此时打开浏览器开发者工具(F12)→ 切换到 Network 标签页 → 点击播放按钮 → 在过滤栏输入 “m3u8” 或 “mp4” → 找到类型为 media 的请求 → 右键该请求 → Copy → Copy link address → 粘贴出来的就是带签名的直链地址。
这一步必须在视频开始加载后触发,提前复制或刷新页面会导致链接失效;且该地址含临时 token,不可长期保存复用。











