视频延长 Extend

视频延长用于在已有视频基础上继续生成后续内容。可使用 PixVerse 已生成的视频 source_video_id，也可以使用上传视频的 video_media_id。

能力示例视频

接入流程

准备源视频 -> 发起 Extend 任务 -> 查询任务状态 -> 获取延长后视频

接口地址

源视频信息

视频来源

参数	说明
`source_video_id`	PixVerse 生成的视频 ID
`video_media_id`	通过「上传资源」接口上传的视频 ID

source_video_id 与 video_media_id 必须且只能传入一个；同时传入、均未传入或两者均为 0 时校验失败，返回 HTTP 400，业务错误码 400017。

视频规则

时长：源视频 ≤30 秒；延长后累计总时长 ≤40 秒。

大小：≤50 MB。

分辨率：宽、高均 ≤1920 px；代码未设置最小分辨率，另要求帧率 ≤120 FPS。

连续延长：没有固定次数上限，按累计总时长控制40s

请求参数

参数	类型	是否必填	说明
`source_video_id`	integer	条件必填	与 `video_media_id` 必须且只能填写一个
`video_media_id`	integer	条件必填	与 `source_video_id` 必须且只能填写一个
`prompt`	string	是	延长内容描述，最长 `5000` characters
`model`	string	是	模型名称：`v6`
`duration`	integer	是	延长时长；`v6` 支持 `1~15` 秒。
`quality`	string	是	`360p`、`540p`、`720p`、`1080p`
`seed`	integer	否	随机种子

最小请求示例

{
  "source_video_id": 123456,
  "prompt": "The camera continues moving forward into the city",
  "model": "v6",
  "duration": 5,
  "quality": "720p"
}

响应字段

字段	类型	说明
`ErrCode`	integer	错误码，`0` 表示成功
`ErrMsg`	string	错误信息，成功时通常为 `Success`
`Resp.video_id`	integer	视频任务 ID，后续用于查询任务状态
`Resp.credits`	integer	任务创建时的预计/预扣成本，不代表最终账户净扣款

响应示例

{
  "ErrCode": 0,
  "ErrMsg": "Success",
  "Resp": {
    "video_id": 123456,
    "credits": 60
  }
}

下一步

调用「查询任务状态」接口，通过返回的 video_id 获取生成进度和最终视频 URL。

注意事项

source_video_id 和 video_media_id 必须且只能填写一个；同时填写、均不填写或均为 0 均会校验失败（HTTP 400，业务错误码 400017）。

prompt 建议描述“接下来发生什么”，而不是重新描述整段视频。

上传视频需先通过「上传资源」获得 media_id。

视频延长 Extend