img_uuid，然后进行轮询或接收回调，直到任务成功或失败。用于视频生成的 Vidu Q3 Pro API
通过独立的 GoEnhance 开放 API 访问 Vidu Q3 Pro，实现文生视频、图生视频以及首尾帧生成。提交一个异步请求，保存返回的
获取 API 密钥
构建清晰的 Vidu Q3 Pro API 请求
单一端点支持三种输入模式
向 https://api.goenhance.ai/api/v1/videos/generations 发送 POST 请求，并使用 model: viduq3_pro。仅使用提示词进行文生视频，添加 image_url 作为首帧，或添加 image_end_url 进行首尾帧生成。
明确的控制与异步完成机制
在提交前验证时长、分辨率和文生视频比例。保存返回的任务 ID，然后使用 GET /api/v1/jobs/detail 或公共 HTTPS custom_callback_url 来处理最终结果。
在任务进入视频流水线之前，请确保符合记录的请求架构。
Vidu Q3 Pro API 功能与参数
模型
将 <code>model</code> 设置为 <code>viduq3_pro</code>。
提示词
提供描述目标视频的必要文本提示词。
首帧
添加公共 <code>image_url</code> 以进行图生视频生成；文生视频时可省略。
尾帧
同时添加 <code>image_end_url</code> 和 <code>image_url</code> 以实现首尾帧控制。
时长
选择 1 到 16 秒之间的整数。默认值为 5 秒。
分辨率与比例
分辨率支持 540p、720p 或 1080p，默认为 720p。<code>ratio</code> 字段适用于文生视频请求。
生成成本估算方式为：所选的每秒费率乘以请求的时长。
Vidu Q3 Pro API 定价
540p
每生成一秒消耗 2.25 个 Token，按记录的每 Token $0.02费率计算，即每秒 $0.045。
720p
每生成一秒消耗 5 个 Token，按记录的每 Token $0.02费率计算，即每秒 $0.10。
1080p
每生成一秒消耗 6 个 Token，按记录的每 Token $0.02费率计算，即每秒 $0.12。
分六步集成 Vidu Q3 Pro
1
1. 创建 API 密钥
创建一个 GoEnhance 密钥，并将其作为 Authorization 请求头中的 bearer token 发送。
2
2. 选择输入模式
仅使用提示词，添加首帧 URL，或同时添加首帧和末帧 URL。
3
3. 验证请求
设置
viduq3_pro，时长为 1-16 秒，并选择文档中支持的分辨率值之一。 4
4. 提交视频任务
向
/api/v1/videos/generations 发送 POST 请求，并持久化保存返回的 img_uuid。 5
5. 跟踪状态
轮询
GET /api/v1/jobs/detail 或配置一个公共 HTTPS 回调 URL。 6
6. 处理完成状态
以幂等方式处理成功和失败状态，并在下游使用前验证返回的资产。
围绕明确的输入和终端任务状态构建可重复的视频生成工作流。
Vidu Q3 Pro API 的开发者用例
营销视频变体
根据结构化提示词生成简短的概念片段，用于创意评审和下游组装。
产品动态
在您的应用程序控制提示词、验证和资产评审的同时，为已批准的产品画面制作动画。
故事板转场
使用首帧和末帧输入来探索两个已批准视觉节点之间的动态效果。
本地化创意流水线
为区域性营销变体参数化提示词，而无需更改异步任务处理程序。
社交视频制作
创建由您的应用程序选择分辨率和时长的简短动态资产。
预可视化
在全面制作之前，将简洁的镜头描述转化为可供评审的动态概念。
关于定价、输入、任务状态以及生数视频 API 常见问题的解答。