本文将介绍 Veo Reshoot API 的对接说明。该接口用于对一段已经生成的 Veo 视频按照新的镜头运动方式重新生成,画面内容保持一致,但镜头机位与运动会按 motion_type 重新演绎。
申请流程
要使用 API,需要先到 Veo 服务对应页面申请。如果你尚未登录或注册,会自动跳转到登录页面。
基本使用
调用本接口需要传入下列参数:
video_id(必填):来源视频的任务 ID。不能是/veo/extend的输出视频。motion_type(必填):新的镜头运动方式,使用大写下划线风格的简洁别名。
motion_type 支持值
| 别名 | 含义 |
|---|---|
STATIONARY |
镜头固定不动 |
STATIONARY_UP |
镜头固定,向上俯仰 |
STATIONARY_DOWN |
镜头固定,向下俯仰 |
STATIONARY_LEFT |
镜头固定,左摇 |
STATIONARY_RIGHT |
镜头固定,右摇 |
STATIONARY_DOLLY_IN_ZOOM_OUT |
镜头固定,前推 + 推焦 |
STATIONARY_DOLLY_OUT_ZOOM_IN |
镜头固定,后退 + 拉焦 |
UP |
镜头上升 |
DOWN |
镜头下降 |
LEFT_TO_RIGHT |
镜头从左向右平移 |
RIGHT_TO_LEFT |
镜头从右向左平移 |
FORWARD |
镜头向前推进 |
BACKWARD |
镜头向后退 |
DOLLY_IN_ZOOM_OUT |
移动中前推 + 推焦 |
DOLLY_OUT_ZOOM_IN |
移动中后退 + 拉焦 |
请求示例:
1 |
curl -X POST 'https://api.acedata.cloud/veo/reshoot' \ |
返回结果结构与 /veo/videos 相同。
计费说明
- 单次重拍:1.20 Credit。
异步回调
接口支持异步模式,传入 callback_url 即可在任务完成后通过 POST 请求回调结果。若无公网回调地址,也可将 async 设为 true,接口同样立即返回 task_id,随后通过对应的任务查询接口轮询获取结果。