# 既存動画を延長
> 元クリップの終端から先を継続生成します。

元クリップの終端から先を継続生成します。

## Agent の基本フロー

既存クリップの終端から先を生成するには `beatra.videos.extend` を使います。
既存タイムライン自体を変更する場合は edit を使います。

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` は 1 秒 225 / 335 クレジット（標準 / 上位）。

## タスクの状態とリカバリー

`queued` または `running` の間は同じタスクを確認します。作成応答を失った
場合は同じ引数と `client_request_id` だけで再試行します。元動画、指示、
モデル、長さの変更には新しい ID が必要です。

## REST で呼び出す

直接プロトコル統合では `POST /v1/videos/extend` を使います。完全なリクエスト契約は
生成された [API 操作](https://docs.beatra.ai/ja/docs/api-reference/operations/videos/videos_extend_v1_videos_extend_post)
を参照してください。推奨の統合方法は Skill + MCP です。REST はカスタムアプリケーション向けです。