img_uuid，并通过轮询或回调接收生成的视频。用于保持视频主体一致性的 Vidu Q3 Turbo 参考 API
通过独立的 GoEnhance 开放 API 访问 Vidu Q3 Turbo 参考 API。发送 1–7 张参考图像及提示词，保留返回的
获取 API 密钥
构建有效的参考转视频请求
在提交生产任务前，请验证仅参考模式的契约。
Vidu Q3 Turbo 参考 API 功能与参数
精确模型 ID
将 <code>model</code> 设置为 <code>viduq3_turbo_reference</code>；请务必保留下划线。
必填提示词
在 <code>prompt</code> 中描述预期的动作、场景、摄像机行为和视觉处理方式。
参考数组
通过 <code>image_urls</code> 提供 1–7 个公共图片 URL。
仅参考路由
请勿发送 <code>image_url</code> 或 <code>image_end_url</code>；这些模式请使用 <code>viduq3_turbo</code>。
持续时间
选择 1 到 16 秒之间的整数。文档默认值为 5 秒。
分辨率
使用 <code>540p</code>、<code>720p</code> 或 <code>1080p</code>；文档默认值为 <code>720p</code>。
总成本估算方式为：所选的每秒费率乘以请求的持续时间。
Vidu Q3 Turbo 参考 API 定价
540p
每生成 1 秒消耗 1 个 token，按文档中每 token $0.02 的费率计算，即每秒 $0.02。
720p
每生成 1 秒消耗 2.5 个 token，按文档中每 token $0.02 的费率计算，即每秒 $0.05。
1080p
每生成 1 秒消耗 3.25 个 token，按文档中每 token $0.02 的费率计算，即每秒 $0.065。
分六步集成 Vidu Q3 Turbo 参考 API
1
1. 创建 API 密钥
创建一个 GoEnhance 密钥，并将其作为承载令牌（bearer token）放入 Authorization 请求头中。
2
2. 准备参考资料
托管 1–7 张已批准的参考图像，并提供您的请求可在
image_urls 中使用的公共 URL。 3
3. 验证有效载荷
设置确切的模型 ID、提示词、持续时间和一种已记录的分辨率；省略仅限首帧的字段。
4
4. 提交任务
向
/api/v1/videos/generations 发送 POST 请求，并持久化返回的 img_uuid。 5
5. 跟踪状态
轮询
GET /api/v1/jobs/detail 或提供一个公共 HTTPS 回调 URL。 6
6. 处理完成情况
以幂等方式处理最终的成功或失败状态，并在下游使用前验证返回的视频。
构建可重复的流水线，利用已批准的视觉输入来引导生成的场景。
参考驱动型视频的开发者用例
角色连贯性
使用多个已批准的角色视图来引导生成的短片中反复出现的主体。
产品故事讲述
提供产品参考和场景提示词，以获得可供审查的营销活动概念。
营销活动变体
重复使用已批准的视觉参考集，同时针对不同的投放位置或故事节点更改提示词。
预可视化
在全面制作之前，将角色、道具和环境参考转化为动态概念。
本地化创意
参数化场景提示词，同时在不同地区的变体中保持相同的已批准视觉参考。
系列化内容
在独立提交的异步任务中引导反复出现的主体和艺术指导。
关于输入、定价、任务状态以及生数 API 常见问题的解答。