延长(Extend)功能使用指南

延长（Extend)接口提供了延续和增强您的视频内容。它分析给定视频的结尾片段，并使用AI生成技术向后扩展故事。
通过提示词、风格和模板等参数，您可以以创意和个性化的方式无限延长您的视频。

接口地址：POST https://app-api.pixverseai.cn/openapi/v2/video/extend/generate

在线调用：

上传资源（视频/音频）：https://docs.platform.pai.video/311775440e0

生成延长（Extend）视频：https://docs.platform.pai.video/311775863e0

前提条件

开始之前，请确保您拥有：

有效的拍我AI API 密钥

每个API请求的唯一 Ai-trace-id

已开通并激活订阅计划，且账户中有足够可用额度；

以下任一：

从拍我AI 生成的 video_id
或者

支持格式的上传视频（mp4、mov）

最大分辨率：1920

最大文件大小：50MB

最大时长：30秒

快速调用

1: 准备视频

2. Extend 生成任务请求

3. 查询视频是个不该吃个表格状态&下载视频

使用步骤

您可以通过两种方式输入视频：

步骤 1-1：准备外部视频

外部视频（用户提供）

为确保最佳效果，请提供：

.mp4 或 .mov 视频文件

最大分辨率：1920p

最大大小：50MB

最大时长：30秒

使用适当的参数构建您的API请求：

您将获得带有"video"媒体类型的"media_id"

{
    "ErrCode": 0,
    "ErrMsg": "success",
    "Resp": {
        "media_id": 0,
        "media_type": "video",
        "url": "https://media.pixverseai.cn/111111.mp4"
    }
}

步骤 1-2：从拍我AI API 准备视频

如果您之前使用我们的API生成了视频，您应该已经有一个 video_id。
要扩展此视频，请将 video_id 传递到生成请求的 source_video_id 字段中。

步骤 2：发送延长(Extend)API请求

🔧 参数详情

参数名称	必需	类型	描述
source_video_id	选择 source_video_id 或 video_media_id 之一，不能同时使用	int	来自拍我AI API 的视频
video_media_id	选择 source_video_id 或 video_media_id 之一，不能同时使用	int	上传的外部视频
model	必需	string	v3.5/v4/v4.5
prompt	必需	string	小于等于 2048 字符
negative_prompt	可选	string	小于等于 2048 字符
img_id	必需	integer	上传图片接口后的图片ID。图片转视频生成时必需
template_id	可选	integer	使用前必须在效果管理中激活效果。某些效果不支持特定分辨率，请检查效果管理
style	可选	string	"anime" "3d_animation" "day" "cyberpunk" "comic" 除非需要，否则不要包含 style 参数
motion_mode	可选	string	默认 - "normal" "fast"（仅允许5秒时长） 1080p 不支持"fast"。如果未提供，默认为 normal
duration	必需	integer	5,8 1080p 不支持 8
quality	必需	string	"360p"（Turbo模型）、"540p"、"720p"、"1080p"
seed	可选	integer	随机种子，0-2147483647 之间的 int32 随机数

步骤 3. 处理API响应

API返回包含 video_id 的JSON响应：

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "Resp": {
    "video_id": 0
  }
}

步骤 4 检查生成状态

创建任务后，您将收到一个 video_id

使用此 video_id 定期查询获取视频生成状态API

处理完成时，状态将从 5 变为 1

  {
 "ErrCode": 0,
 "ErrMsg": "string",
 "Resp": {
   "create_time": "string",
   "id": 0,
   "modify_time": "string",
   "negative_prompt": "string",
   "outputHeight": 0,
   "outputWidth": 0,
   "prompt": "string",
   "resolution_ratio": 0,
   "seed": 0,
   "size": 0,
   "status": 5,
   "style": "string",
   "url": "string"
 }
}

步骤 5 下载生成的视频

您可以通过"url"访问生成的视频

  {
 "ErrCode": 0,
 "ErrMsg": "string",
 "Resp": {
   "create_time": "string",
   "id": 0,
   "modify_time": "string",
   "negative_prompt": "string",
   "outputHeight": 0,
   "outputWidth": 0,
   "prompt": "string",
   "resolution_ratio": 0,
   "seed": 0,
   "size": 0,
   "status": 1,
   "style": "string",
   "url": "string"
 }
}

故障排除

常见问题

您的视频卡在"生成中"状态，长时间等待后仍未完成。

请检查您是否为每个请求使用相同的 AI-trace-ID。这是导致此问题的最常见原因。

状态代码：1：生成成功；5：等待生成；7：内容审核失败；8：生成失败；

如果遇到状态代码 7，意味着您生成的视频被我们的内容审核系统过滤。请修改参数后重试。用于被过滤视频的积分将自动退还到您的账户。

常见错误代码

400/500 状态：代码错误

400013：无效的绑定请求：参数类型或值不正确

400017：无效参数

500044：达到并发生成限制

前提条件#

快速调用#

使用步骤#

步骤 1-1：准备外部视频#

步骤 1-2：从 拍我AI API 准备视频#

步骤 2：发送延长(Extend)API请求#

步骤 3. 处理API响应#

步骤 4 检查生成状态#

步骤 5 下载生成的视频#

故障排除#

常见问题#

常见错误代码#