首先,明确几个关键要点。若要通过Vidu API将产品图片自动转换为1080P旋转展示视频,必须确保API Key与Endpoint同属北京区域、构建包含毫秒级时间戳的认证头、提交包含合法image_url的JSON请求体。跨地域调用将直接返回403错误,image_url不能使用本地路径或内网地址,video-synthesis接口仅返回task_id而非视频文件。简而言之,这三步紧密相连,任何一个环节出错,整个流程都将中断。

开通服务并获取北京地域的API Key
第一步:登录阿里云百炼控制台,进入“大模型服务平台百炼”。
第二步:在搜索栏中输入“vidu”,找到Vidu模型卡片,点击“立即开通”,勾选相关协议并完成授权。
第三步:进入“API密钥管理”页面,【务必手动切换地域为中国内地(北京)】,点击“创建密钥”,复制生成的sk-开头的API Key——此密钥不能用于上海或新加坡地区的Endpoint。
构造精准认证请求头
方法一:Bearer Token认证(推荐新手使用)
设置请求头Authorization的值为Bearer sk-xxxxx,注意Bearer后面【必须有且仅有一个英文半角空格】,然后紧跟API Key,中间不能换行、不能加引号、不能包含中文空格。
方法二:HMAC签名认证(适用于需要防重放攻击的生产环境)
拼接待签名字符串:method + access_key + timestamp + v,其中timestamp必须是当前毫秒级整数;使用密钥计算HMAC-SHA256,经过Base64编码后填入sign字段;同时,在请求头中添加X-Vidu-Timestamp和X-Vidu-Signature。
提交图生视频异步任务
1. 向北京地区的Endpoint发送POST请求:
https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
2. 请求体必须采用JSON格式,并包含以下三个核心字段:
• model:固定填写"vidu-v1"
• input:对象包含image_url(公网可直接访问的PNG/JPG格式URL,需使用HTTPS)和p(提示词,例如"缓慢顺时针360度旋转,纯白背景,1080p,9秒")
• parameters:对象中设置resolution为"1080p",video_length_seconds为9
3. 成功响应返回JSON,包含task_id字段——该ID有效期为24小时,用于后续轮询查询结果。
