既存動画を延長

Agent の基本フロー

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

ローカルの元動画をアップロードします。
capability: "video_extend" で beatra.models.list を呼び、クリップ制限、最終長の規則、制御、価格を確認します。
続きの内容と必要な最終構図だけを記述します。
一つの client_request_id で一度だけ送信し、beatra.tasks.get で確認します。

AI ガイド

AI 連携 Markdown

独自アプリケーションに組み込む場合は、この API ガイドを Claude や Codex などにコピーできます。

ツール引数

{
  "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 を正とします。最終長を黙って書き換えてはいけません。

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

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

REST で呼び出す

直接プロトコル統合では POST /v1/videos/extend を使います。完全なリクエスト契約は生成された API 操作を参照してください。推奨の統合方法は Skill + MCP です。REST はカスタムアプリケーション向けです。