要实时掌握腾讯混元文生视频任务状态，需用describevideoeditklingjob接口查询合法jobid：status为wait、run、done、fail分别表示排队、渲染中、完成、失败；resultvideourl有效期24小时。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要实时掌握腾讯混元文生视频任务的执行状态，比如刚提交一个“骆驼商队在沙丘间前行”的视频生成请求，现在想知道它是在排队、渲染中，还是已经失败或生成完成。
确认任务ID是否已获取
调用查询接口前，必须已有合法有效的 【JobId】。该ID来自你此前调用 SubmitVideoEditKlingJob 或 SubmitHunyuanVideoJob 接口成功返回的 JobId 字段，不是前端控制台看到的任务编号，也不是 ExternalTaskId。
若你手头只有 ExternalTaskId，请改用 DescribeVideoEditKlingJob 接口并传入 ExternalTaskId 参数——但注意：该字段仅在首次提交时由你指定，服务端不会自动补全或反查。
使用DescribeVideoEditKlingJob查询进度
这是腾讯云官方为Kling-Omni-Video系列任务指定的唯一查询接口，域名固定为 vclm.tencentcloudapi.com，不适用于混元生3D或文生图类任务。
第一步：构造 POST 请求，Header 中必须包含 X-TC-Action: DescribeVideoEditKlingJob、X-TC-Version: 2024-05-23、X-TC-Region: ap-guangzhou（或其他你调用时使用的实际地域）；
第二步：Body 内使用 JSON 格式传入参数，至少包含 {"JobId": "1350360280588853248"}；
第三步：发送请求后，检查返回 JSON 中的 Status 字段值——WAIT 表示未开始，RUN 表示正在生成，DONE 表示成功且 ResultVideoUrl 可用，FAIL 表示失败并需结合 ErrorCode 和 ErrorMessage 排查；
这一步操作起来很简单，直接把文件拖进去就行。但务必注意：ResultVideoUrl 有效期仅24小时，过期链接将无法访问，需及时下载或转存。
通过API Explorer快速验证
方法一：打开腾讯云 API Explorer（搜索“vclm DescribeVideoEditKlingJob”直达），选择对应地域，填入 JobId 后点击【发起请求】，页面会实时显示请求参数、响应内容和自动生成的 Python/Java/Go 等 SDK 示例代码；
方法二：在 API Explorer 中点击【调试】按钮右侧的【生成 SDK】→选择语言→复制粘贴到本地运行，比手动拼签名快得多；
方法三：勾选【自动轮询】选项，设置间隔秒数（如5秒），可连续观察 Status 变化过程，避免自己反复手动刷新。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
