0%

Veo Reshoot API 对接说明

本文将介绍 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
2
3
4
5
6
7
8
curl -X POST 'https://api.acedata.cloud/veo/reshoot' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"video_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
"motion_type": "LEFT_TO_RIGHT"
}'

返回结果结构与 /veo/videos 相同。

计费说明

  • 单次重拍:1.20 Credit。

异步回调

接口支持异步模式,传入 callback_url 即可在任务完成后通过 POST 请求回调结果。若无公网回调地址,也可将 async 设为 true,接口同样立即返回 task_id,随后通过对应的任务查询接口轮询获取结果。