延长已有视频

Agent 主路径

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

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

AI 指南

给 AI 的集成说明

接入自有应用时，可以把这份 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 适合自定义应用直连。