> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Veo Extend API 对接说明

> Veo Video Generation 集成指南 - Ace Data Cloud

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

## 申请流程

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

## 基本使用

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

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

请求示例：

```shell theme={null}
curl -X POST 'https://api.acedata.cloud/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.acedata.cloud/veo/5fa2d9a6.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}
```

## 重要限制

`video_id` 必须来自当前 `/veo/videos` 线路生成或延展完成后的 `data[].id`。更早的历史线路生成的视频 ID 无法用于该接口，调用时会返回 `400 bad_request`；请通过 `/veo/videos` 重新生成后再延展。

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

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

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

## 计费说明

* `model=veo31-fast`：1.68 Credit / 次
* `model=veo31`：12.00 Credit / 次

## 异步回调

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