延长（Extend)接口使用指南

概述

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

端点： POST:

先决条件

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

有效的拍我AI API 密钥
每个API请求的唯一 Ai-trace-id
购买的API积分或有效订阅
以下任一：
- 从拍我AI 生成的 video_id
  或者
- 支持格式的上传视频（mp4、mov）
- 最大分辨率：1920
- 最大文件大小：50MB
- 最大时长：30秒

分步指南

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

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

外部视频（用户提供）

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

.mp4 或 .mov 视频文件
最大分辨率：1920p
最大大小：50MB
最大时长：30秒

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

curl --location --request POST 'https://app-api.pixverseai.cn/openapi/v2/media/upload' \
--header 'Ai-Trace-Id: 123123' \
--header 'API-KEY: 123123' \
--form 'file=@"/www/xxx/yyy/zzz.mp4"'

您将获得带有"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请求

curl --location --request POST 'https://app-api.pixverseai.cn/openapi/v2/video/extend/generate' \
--header 'Ai-Trace-Id: 123123' \
--header 'API-KEY: 123123' \
--header 'Content-Type: application/json' \
--data-raw '{
  "source_video_id": 0,
  "video_media_id" :0, 
  "prompt": "across the universe",
  "seed": 123123,
  "quality": "540p",
  "duration": 5,
  "model": "v4.5",
  "motion_mode": "normal"
  }'

🔧 参数详情

参数名称	必需	类型	描述
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：达到并发生成限制

概述