> ## 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 Extend API 对接说明

> Veo Video Generation 集成指南 - XHuoAPI

本文将介绍 Veo Extend API 的对接说明。该接口用于对一段已经生成的 Veo 视频进行**时长延展**，AI 会自动续写后续画面。

## 申请流程

要使用 API，需要先到 Veo 服务对应页面申请。如果你尚未登录或注册，会自动跳转到登录页面。

## 基本使用

调用本接口需要传入下列参数：

* `video_id`（必填）：来源视频的任务 ID（来自 `/veo/videos` 或本接口本身）。
* `model`（必填）：用于延展的模型，**仅支持 `veo31-fast` 和 `veo31` 两个模型**，其他模型上游不支持。
* `prompt`（选填）：用于引导延展段画面的文字提示。

请求示例：

```shell theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/veo/extend' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "video_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
    "model": "veo31-fast",
    "prompt": "the camera slowly zooms out to reveal more of the landscape"
  }'
```

返回结果与 `/veo/videos` 相同：

```json theme={null}
{
  "success": true,
  "task_id": "5fa2d9a6-7e54-481b-a4b0-3dc6f25dd2ab",
  "data": [
    {
      "id": "9b6f3b6b9c45419fbf2e3fe2f10b2b3a",
      "video_url": "https://platform.cdn.xhuoapi.ai/veo/5fa2d9a6.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}
```

## 重要限制

来自 `/veo/extend` 的延展结果视频可以**继续被 `/veo/extend` 再次延展**，但是**不能**再被以下接口处理：

* `/veo/reshoot` —— 不能换镜头运动
* `/veo/objects` —— 不能再做物体增删

如果传入的 `video_id` 是延展结果，相关接口会返回 400 错误，请改用原始视频作为来源。

## 计费说明

* `model=veo31-fast`：1.20 Credit / 次
* `model=veo31`：7.64 Credit / 次

## 异步回调

接口支持异步模式，传入 `callback_url` 即可在任务完成后通过 POST 请求回调结果。