首尾帧功能使用指南

功能概览

该功能需要两张图片：首帧图片，视频开头展示的画面；尾帧图片，视频结尾展示的画面。系统将自动在这两帧间生成平滑的过渡动画，打造视觉冲击力强的画面效果。

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

在线调用： https://docs.platform.pai.video/300925918e0

前提条件

在使用本接口前，请确保您已具备：

有效的拍我AI API Key；

每次请求都携带唯一的 Ai-trace-id；

购买的API积分或有效订阅

待处理图片格式为 JPG/PNG/WebP，尺寸不超过 4000×4000 像素，文件大小 ≤ 20 MB。

使用步骤

1. 上传首尾帧图片

使用图片上传接口分别上传首帧和尾帧图片，记录返回的img_id。

2. 创建转场任务

向转场生成功能接口提交请求，传入以下参数：

prompt：对转场过程的文字描述，如“变形为小狗”

model：使用模型版本（例如 "v3.5"）

duration：时长（秒），可选 5 或 8

quality：分辨率质量，可选"360p""540p""720p""1080p"

motion_mode：动作模式，"normal" 或 "fast"

seed：随机种子，范围 0–2147483647

first_frame_img：首帧图片的 img_id

last_frame_img：尾帧图片的 img_id

3. 查询任务进度

提交任务后会返回一个video_id

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

使用“获取视频生成状态”接口轮询 video_id，监控 status 字段；

当 status 从 5 变为 1 时，即可通过 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": 5,
   "style": "string",
   "url": "string"
 }
}

4. 查看/下载结果

任务完成后，接口返回的 url 即为视频访问或下载链接，可直接在浏览器中打开或在程序中下载。

功能概览#

前提条件#

使用步骤#

1. 上传首尾帧图片#

2. 创建转场任务#

3. 查询任务进度#