img_uuid 进行轮询或接收状态回调。用于一致性视频生成的 Vidu Q3 Reference API
通过独立的 GoEnhance 开放 API 访问 Vidu Q3 Reference。提供 1–7 张参考图及提示词，提交异步视频任务，随后使用返回的
获取 API 密钥
构建 Vidu Q3 Reference API 请求
为一致性而构建的参考图输入
向 https://api.goenhance.ai/api/v1/videos/generations 发送 POST 请求，设置 model: viduq3_reference，包含必需的提示词，以及包含 1–7 张公共参考图的 image_urls。
已验证的请求与异步结果
提交前请验证图像格式、尺寸、宽高比、时长、分辨率和输出比例。保留 img_uuid，然后轮询 GET /api/v1/jobs/detail 或使用公共 HTTPS 回调。
提交任务前，请确保符合文档记录的参考图到视频请求架构。
Vidu Q3 Reference API 功能与限制
模型与提示词
将 <code>model</code> 设置为 <code>viduq3_reference</code> 并提供描述预期视频的必要文本提示词。
参考图像
在 <code>image_urls</code> 中发送 1–7 个 URL。每张图像必须为 PNG、JPEG、JPG 或 WebP 格式；至少 128×128 像素；不超过 50 MB；且宽高比在 1:4 到 4:1 之间。
专用输入模式
此路由接受 <code>image_urls</code>，而非 <code>image_url</code> 或 <code>image_end_url</code>。对于纯文本、首帧或首尾帧生成，请使用 <code>viduq3_pro</code>。
时长
选择 3 到 16 秒之间的整数。文档默认值为 5 秒。
分辨率
选择 <code>540p</code>、<code>720p</code> 或 <code>1080p</code>。文档默认值为 <code>720p</code>。
输出比例
将 <code>ratio</code> 设置为 <code>16:9</code>、<code>9:16</code> 或 <code>1:1</code>；文档默认值为 <code>16:9</code>。<code>aspect_ratio</code> 可作为兼容的别名使用。
费用估算方式为：所选的每秒费率乘以请求的时长。
Vidu Q3 Reference API 定价
540p
每生成一秒消耗 1.75 个 token，按文档中每 token $0.02 的费率计算，等于每秒 $0.035。
720p
每生成一秒消耗 3 个 token，按文档中每 token $0.02 的费率计算，等于每秒 $0.06。
1080p
每生成一秒消耗 3.75 个 token，按文档中每 token $0.02 的费率计算，等于每秒 $0.075。
分六步集成 Vidu Q3 Reference
1
1. 创建 API 密钥
创建 GoEnhance 密钥，并将其作为 Authorization 请求头中的 bearer token 发送。
2
2. 准备参考图
在公共 URL 上托管 1–7 张合规的参考图像，并确定提示词应保留哪些视觉细节。
3
3. 验证请求
设置
viduq3_reference、3–16 秒的时长、支持的分辨率以及支持的比例。 4
4. 提交任务
向
/api/v1/videos/generations 发送 POST 请求，并持久化返回的 img_uuid。 5
5. 跟踪状态
轮询
GET /api/v1/jobs/detail 或配置公共 HTTPS custom_callback_url。 6
6. 处理完成
幂等地处理成功和失败状态，然后在下游使用前验证生成的资产。
围绕明确的输入和终端任务状态，构建可重复的“参考图转视频”工作流。
Vidu Q3 Reference API 的开发者用例
角色主导的营销短片
将获批的虚构角色或人才参考资料应用到短视频营销概念中。
产品标识序列
使用多个获批的产品视图作为视觉参考，进行以动态为中心的创意探索。
故事连贯性
在为故事板和预演工作流生成独立镜头时，引用重复出现的主体。
本地化创意变体
在复用获批视觉参考的同时，针对区域性营销概念调整提示词。
风格统一的社交媒体资产
围绕一组受控的视觉参考和输出比例构建短视频流水线。
创意原型设计
在投入更广泛的生产工作流之前，测试参考组合、提示词、时长和分辨率。
关于定价、参考输入、异步任务和生数 API 常见问题的解答。