# 延长已有视频
> 从源片段结尾继续生成。

从源片段结尾继续生成。

## Agent 主路径

使用 `beatra.videos.extend` 从现有片段结尾继续生成。如果要修改已有时间线，
应使用编辑工具。

1. 上传本地源视频。
2. 用 `capability: "video_extend"` 调用 `beatra.models.list`，读取片段限制、
   最终时长规则、控制项与价格。
3. 只描述续写内容与必要的最终构图。
4. 使用一个 `client_request_id` 提交一次，再用 `beatra.tasks.get` 轮询。

## AI 指南

AI integration guide: https://docs.beatra.ai/llms/videos-video-extend.md

## 工具参数

```json
{
  "instruction": "继续当前镜头运动，直到列车驶入隧道",
  "video": { "type": "artifact", "artifact_id": "artifact_source_clip" },
  "direction": "after",
  "resolution": "720p",
  "duration": 12,
  "client_request_id": "vid-extend-opaque-1"
}
```

`direction` 为必填（`after` 表示向片尾之后续写）。`duration` 表示包含源片段
在内的最终总时长，不是“新增多少秒”。

## 模型、控制与成本

通用控制项包括 `prompt`、`negative_prompt`、`resolution`、
`duration`、`aspect_ratio`、`seed`、`enhance_prompt` 和 `watermark`；
每一项都应按所选模型的元数据使用。

可选模型、源片段限制、最终时长范围、分辨率、派生宽高比、默认
值和价格输入均以 `beatra.models.list` 为准。最终时长必须适用于源片段，
不得静默改写。

### Wan 3.0

设置 `model: "wan3.0-video"` 或 `wan3.0-video-prime`。`duration` 是最终文件时长（2–30 秒），
必须比源视频至少长 2 秒，且源秒加最终秒不超过 30。源视频最长 15 秒。只支持
`direction: "after"`。源秒与最终文件秒按同一费率计费；`480p` 为每秒 225 / 335 积分（标准版 / 高阶版）。

## 任务状态与恢复

任务处于 `queued` 或 `running` 时持续轮询同一个任务。创建响应丢失时，只能
用相同参数与同一 `client_request_id` 重试。源视频、指令、模型或
时长有变化时，必须使用新 ID。

## 通过 REST 调用

直接协议集成使用 `POST /v1/videos/extend`。完整请求契约请参阅生成的
[API 操作定义](https://docs.beatra.ai/zh/docs/api-reference/operations/videos/videos_extend_v1_videos_extend_post)。
推荐通过 Skill + MCP 接入；REST 适合自定义应用直连。