海螺 Responses 创建视频

功能介绍

通过 POST /v1/responses 生成视频，适用于已使用 Responses 结构的应用。推荐 background=true，先获得响应 ID，再查询结果。

鉴权与操作步骤

所有请求发送到 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。实际业务请在服务端保存密钥，不要放进公开网页。

请求参数

model（字符串，必填）为本目录模型表中的精确名称。input 为字符串或消息数组：文本项用 {"type":"input_text","text":"..."}，图片项用 {"type":"input_image","image_url":"https://..."}。这里是视频输入，不是普通聊天回复或任意工具调用。

seconds 为时长，优先于兼容字段 duration；metadata 为对象，放置模型专属参数。background、stream 为布尔值。模型限制仍与统一视频一致；换一种协议不会增加模型能力。

input 文本优先于顶层兼容字段 prompt；多个文本项用换行合并。图片按顶层 image → input_reference → images → input 内图片的顺序合并去重，建议统一使用一种输入位置。

海螺会把第一、第二张图片补入 metadata.first_frame_image / last_frame_image，显式 metadata 首尾帧优先。传统系列首尾帧只按 02 的能力使用；2.3/Fast 不要仅因为接口能接受第二张图片就认定支持尾帧。H3 的参考模式请使用 metadata.content，并同时提供 input 文本，不能仅传 metadata.content 来替代外层 input 校验。

海螺 Responses 的 size 优先于顶层 resolution，然后作为分辨率输入；metadata.resolution 优先于这两者。完整模型字段见统一参数和H3 多模态说明。

运行示例前

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

文生视频示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-Hailuo-2.3",
  "input": "一只小猫在窗边缓慢转头，阳光柔和，镜头平稳。",
  "seconds": 6,
  "background": true,
  "metadata": {
    "resolution": "768P"
  }
}'

首帧图生示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-Hailuo-2.3",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "让画面中的主体自然运动，保持外观一致。"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/first-frame.png"
        }
      ]
    }
  ],
  "seconds": 6,
  "background": true,
  "metadata": {
    "resolution": "768P"
  }
}'

返回结果

保存返回的 id（response ID），然后打开Responses 查询与下载。任务 ID 从返回的 metadata.task_id 读取，不要手动修改 ID 前缀。