海螺首尾帧视频

功能介绍

同时提供首帧和尾帧，生成两张图片之间的连续过渡。传统系列使用 MiniMax-Hailuo-02；H3 的首尾帧写法见H3 页面。

鉴权与操作步骤

所有请求发送到 https://top.qingyuntop.ai。在请求头填写 Authorization: Bearer YOUR_API_KEY，将 YOUR_API_KEY 替换为青云TOP API 控制台创建的 API Key；Bearer 与密钥之间保留一个空格。

1. 携带鉴权请求头，按本页参数创建任务。
2. 保存返回的任务标识，查询至成功后下载视频。创建成功仅表示任务已受理。

JSON 请求使用 Content-Type: application/json。示例中的占位密钥需替换为你的 API Key。实际业务请在服务端保存密钥，不要放进公开网页。

创建接口与参数

POST /v1/videos。填 model=MiniMax-Hailuo-02，在 metadata 中放 first_frame_image 与 last_frame_image，两者为图片 URL 或 data URL 字符串。推荐用 prompt 描述过渡动作。

6 秒支持 768P / 1080P，10 秒仅 768P。官方首尾帧接口不支持 512P；不能照搬单首帧 02 的 512P 组合。图片规格同图生视频，尾图尽量与首图比例一致；上游可能按首图进行裁剪。

运行示例前

cURL 示例使用 Bash 换行语法；Python 需要安装 requests；Node.js 使用 20 或更高版本，将代码保存为 .mjs。带素材的示例必须把 https://example.com/... 替换为上游能直接读取的真实 HTTPS 文件地址，不是网页地址或本机文件路径。

代码示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-Hailuo-02",
  "prompt": "镜头平稳移动，让画面从首帧自然过渡到尾帧。",
  "seconds": 6,
  "resolution": "768P",
  "metadata": {
    "first_frame_image": "https://example.com/start.png",
    "last_frame_image": "https://example.com/end.png"
  }
}'

返回结果与下一步

返回的 id 是本站任务 ID，请原样保存。通过视频任务查询与下载等待 status=completed 后获取 MP4。不要从 ID 猜测厂商任务号，也不要把 progress=100 或存在 completed_at 当作成功条件。