海螺文生视频

功能介绍

用文字描述主体、动作、环境和镜头运动，生成一段视频。此例使用 MiniMax-Hailuo-2.3，6 秒、768P，不需要图片。需要更自由的时长或多模态参考时使用 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、prompt；推荐显式填写 seconds、resolution。2.3 可生成 6 秒 768P/1080P 或 10 秒 768P；2.3-Fast 不能用于纯文生。其余字段见统一视频参数。

运行示例前

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-2.3",
  "prompt": "海边日出，镜头缓慢向前推进，海浪轻拍沙滩，自然光，写实风格。",
  "seconds": 6,
  "resolution": "768P",
  "metadata": {
    "prompt_optimizer": true
  }
}'

返回结果与下一步

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