需完成认证配置、请求构造、异步任务管理及结果获取：一、仅支持北京地域，开通服务并获取同地域api key；二、bearer token认证，严格校验timestamp与签名；三、post提交图生视频任务获task_id；四、轮询get接口查状态，success时取video_url；五、java示例推荐环境变量存密钥、okhttp封装、gson解析及异常处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将 Vidu API 集成到自有应用中实现图生视频、角色驱动或批量视频生成能力，则需完成认证配置、请求构造、异步任务管理及结果获取等关键环节。以下是对接 Vidu API 的完整操作路径：
一、确认服务开通与地域绑定
Vidu API 当前仅支持“中国内地（北京）”地域调用，模型、Endpoint URL 与 API Key 必须严格属于同一地域，跨地域调用将直接返回 403 错误。开通服务需前往阿里云百炼控制台搜索 Vidu，点击模型卡片完成开通与授权，并在对应地域下获取专属 API Key。
1、登录阿里云百炼控制台，定位至“大模型服务平台百炼”。
2、在搜索栏输入 vidu，找到 Vidu 模型卡片。
3、单击“立即开通”，勾选服务协议并确认授权。
4、进入“API 密钥管理”，选择地域为 中国内地（北京），生成并复制 API Key。
二、配置认证与请求头
Vidu API 使用 Bearer Token 认证机制，所有请求必须携带 Authorization 头，且格式不可出现空格或大小写偏差；同时需确保 timestamp 在服务端允许的 20 分钟误差窗口内，否则返回 401 或 429 错误。
1、在代码中构造毫秒级时间戳，例如 Java 中使用 System.currentTimeMillis()。
2、设置请求头：Authorization 值为 Bearer sk-xxxxx（注意 Bearer 后有且仅有一个英文空格）。
3、若使用 vivo 开放平台风格的签名机制（如 hmac），需额外按 method + access_key + timestamp + v 拼接待签名字符串，并用密钥计算 HMAC-SHA256 签名值填入 sign 参数。
三、发起图生视频异步任务
Vidu 图生视频接口采用标准异步模式，调用后立即返回 task_id，不阻塞主线程；后续通过轮询方式获取生成状态与结果 URL，任务 ID 有效期为 24 小时，禁止重复提交相同参数创建新任务。
Vidu视频生成插件（viduq3-pro、viduq3-turbo、viduq2、viduq1）。支持文字转视频、图片转视频、参考转视频以及起始编辑。
1、向北京地域 Endpoint 发起 POST 请求：https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis。
2、请求体为 JSON 格式，必需字段包括 model（固定为 "vidu-v1"）、input（含 image_url 和 prompt）、parameters（如 seed、aspect_ratio）。
3、成功响应中提取 task_id 字段，用于下一步轮询查询。
四、轮询获取任务执行结果
任务提交后需主动轮询结果接口，推荐间隔 3–5 秒发起一次 GET 请求，直至 status 字段变为 “SUCCESS” 或 “FAILED”。轮询超时不应超过 600 秒（10 分钟），因多数图生视频任务在 1–5 分钟内完成。
1、构造轮询 URL：https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}。
2、携带相同 Authorization 头发起 GET 请求。
3、解析响应 JSON，检查 output.video_url 是否存在且非空；若 status 为 “RUNNING”，继续等待并重试。
4、当 status 为 “SUCCESS” 时，video_url 即为可直链播放的 MP4 地址，有效期默认 24 小时。
五、Java 客户端集成示例（OkHttp + Gson）
Java 应用需规避密钥硬编码风险，建议通过环境变量注入 API Key，并封装异步任务提交与轮询逻辑为可复用方法；同时需处理网络异常、HTTP 状态码非 200、JSON 解析失败等边界情况。
1、在系统环境变量中设置 VIDU_API_KEY=sk-xxxxxxxx。
2、使用 OkHttp 构建带 Authorization 头的 POST 请求，请求体使用 MediaType.parse("application/json")。
3、使用 Gson 解析响应，提取 task_id 后启动独立线程执行轮询，避免阻塞主线程。
4、轮询过程中捕获 IOException 与 JsonParseException，对 429 状态码实施指数退避重试策略。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
