首尾帧功能使用指南

功能概览

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

接口地址：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。

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

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

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

提交任务后会返回一个video_id，使用“获取视频生成状态”接口轮询：

当 status 从 5（排队中）变为 1（生成成功）时，即可获取视频下载地址。

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