跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

本文将介绍 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移动中后退 + 拉焦
请求示例:
curl -X POST 'https://api.xhuoapi.ai/v1/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 请求回调结果。