多帧(Multi-transiton)功能使用指南

多帧（Multi-transition）功能允许你通过提供 2–7 张关键帧，生成一段 1–30 秒的视频，保证风格一致、镜头衔接流畅。该功能专为专业创作者设计，能够对视频进行更精细的控制，确保画面中的人物与动作在整个序列中保持连贯和可控。

**接口地址：

前提条件

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

有效的拍我AI API 密钥

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

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

用于多帧的图像，并获得对应的img_id

快速调用

1: 准备图片(img_id)

2. 多帧Multi-transition 生成任务请求

3. 查询视频状态&下载视频

使用步骤

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

步骤 1: 上传图片

使用高质量、清晰的图像，推荐使用高清分辨率以获得更好效果。

上传可

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

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

{
    "ErrCode": 0,
    "ErrMsg": "success",
    "Resp": {
        "img_id": 0,
        "url": "https://media.pixverseai.cn/111111.jpg"
    }
}

步骤 2：发送多帧(Multi-transition)API请求

🔧 参数详情

参数名称	必需	类型	描述
multi_transition	是	array	1. multi_transition 必须是一个包含 2 到 7 个元素的数组。 2. multi_transition 中的每个元素应包含：•img_id（必填，integer）, •duration（必填，integer，最后一个元素不需要填写）,•prompt（可选，string）
model	是	string	v3.5,v4,v4.5,v5
quality	是	string	360p,540p,720p,1080p
motion_mode	否	string	"normal","fast" 2帧效果时, 在 v4.5 或更早版本的模型中，fast_mode: fast 仅支持最长 5 秒的时长。
seed	否	integer	随机种子 0 - 2147483647

步骤 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：无效参数

multi_transition 必须是一个包含 2 到 7 个元素的数组。

multi_transition 中的每个元素应包含：

•img_id（必填，integer）

•duration（必填，integer，最后一个元素不需要填写）

•prompt（可选，string）

最后一个元素的 duration 必须为 0，或可不填。

multi_transition 中每个元素的 duration 必须在 1–8 秒之间。

当 multi_transition 包含 3 个或以上元素时，每个元素的 duration 必须在 1–5 秒之间。

2帧生成时, 在 v4.5 或更早版本的模型中，fast_mode: fast 仅支持最长 5 秒的时长。

500044：达到并发生成限制

多帧(Multi-transiton)功能 使用指南

前提条件#

快速调用#

使用步骤#

步骤 1: 上传图片#

步骤 2：发送多帧(Multi-transition)API请求#

步骤 3. 处理API响应#

步骤 4 检查生成状态#

步骤 5 下载生成的视频#

故障排除#

常见问题#

常见错误代码#