跳转到主要内容

(海螺 Hailuo Image-to-Video)

该接口允许用户上传一张起始帧图片(静态图),并结合文本描述和运镜指令,生成动态视频。

快速开始

视频生成是异步操作,整个流程分为三步:

📌 基础信息

  • 接口地址: POST /v1/video/generations
  • 认证方式: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
  • 内容类型: application/json

📥 请求参数 (Request Body)


🖼️ 图片规格要求

  • 格式: JPG, JPEG, PNG, WebP
  • 体积: 小于 20MB
  • 尺寸: 短边 > 300px,长宽比在 2:5 至 5:2 之间。

🎥 运镜指令 (部分展示)

prompt 中加入 [] 指令实现精确镜头运动:
  • 推拉: [推进], [拉远]
  • 移位: [左移], [右移], [上升], [下降]
  • 摇摆: [左摇], [右摇], [上摇], [下摇]
  • 变焦: [变焦推近], [变焦拉远]

📝 请求示例


📤 响应结果 (Response)

状态码: 200 OK

💡 开发者建议

  1. 图文契合度: prompt 的描述应基于 first_frame_image 的内容进行动作扩展。如果图片是静态风景,Prompt 描述剧烈的人物动作,生成效果可能不佳。
  2. Fast 模型: 如果对生成速度有要求,建议使用 MiniMax-Hailuo-2.3-Fast 模型。
  3. 分辨率策略: MiniMax-Hailuo-02 模型在生成 10s 视频时,最高支持 768P 分辨率。