> ## 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 Video Generation 集成指南 - XHuoAPI

本文将介绍 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`            | 移动中后退 + 拉焦   |

请求示例：

```shell theme={null}
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 请求回调结果。