需调用vclm.tencentcloudapi.com接口,传入规范文本、认证参数及正确region(如ap-guangzhou),secretid/secretkey须从控制台获取;prompt≤200字符,duration为3~8秒,resolution填1080p或720p;成功返回jobid和requestid。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要通过腾讯混元文生视频API提交任务,需调用vclm.tencentcloudapi.com域名下的接口,传入符合规范的文本描述、认证参数及地域信息,否则会返回401或InvalidParameter错误。
准备请求基础参数
打开API Explorer(https://console.cloud.tencent.com/api/explorer),选择产品“视频内容生成”→接口“SubmitVideoGenJob”,自动填充公共参数Region、Version、Action;Region必须填实际部署地域如ap-guangzhou,【填错Region会导致签名验证失败且无明确报错提示】;Version固定为2025-05-13。
在“Authorization”区域点击“自动签名”,粘贴SecretId和SecretKey——这两项必须从腾讯云控制台【访问管理 → API密钥管理】中复制,不能使用临时密钥或已禁用密钥。
构造视频生成请求体
在“Input”栏下,展开“VideoGenInput”对象:
填写Prompt字段:输入中文正向描述,例如“一只橘猫坐在窗台上看雨,窗外梧桐叶被风吹动,写实风格,柔焦镜头”,长度不超过200 UTF-8字符;【空格、换行、emoji均计入字符数,超长将直接拒绝】。
设置Duration:视频时长,单位秒,取值范围3~8,推荐填5;低于3秒任务会被截断,高于8秒将被强制截断并返回警告。
选择Resolution:支持“1080p”或“720p”,填其他值如“4K”会导致参数校验失败。
发起HTTP请求
点击“发送请求”按钮,页面右侧显示完整curl命令示例;若需集成到代码中,直接复制下方“SDK调用示例”中的Python/Java/Go任一语言片段。
成功响应体中会返回JobId(如"1384898587778465792")和RequestId;JobId用于后续轮询任务状态,RequestId用于排查问题,二者都需立即记录。
若返回{"Error":{"Code":"FailedOperation.JobQuotaExceeded","Message":"当前地域任务队列已满"}},说明该Region下并发任务已达上限,需等待30秒后重试,不可提高频率。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











