Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
支持以下模型:
  • MiniMax-Hailuo-2.3 - Hailuo 2.3 模型
  • MiniMax-Hailuo-2.3-Fast - Hailuo 2.3 Fast 模型(更快速度)
MiniMax-Hailuo-2.3-Fast
使用该模型时,first_frame_image 参数必须上传
string
必填
视频内容描述(最多 2000 字符)建议详细描述场景、动作、风格等,以获得更好的生成效果。支持运镜指令(详见下方运镜指令说明)。示例:"一只可爱的猫咪在草地上奔跑"
integer
默认值:"6"
视频时长(秒)可选值:
  • 6 - 6秒视频
  • 10 - 10秒视频
默认值:6
1080p 限制:使用 1080p 分辨率时,仅支持 6 秒时长
string
默认值:"768p"
视频分辨率可选值:
  • 768p - 高清
  • 1080p - 全高清(仅支持 6 秒时长)
默认值:768p
string
视频起始帧图片支持两种格式:
  • 公网 URLhttps://example.com/start.jpg
  • Base64 编码data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
传入后将以该图片作为视频的起始画面
MiniMax-Hailuo-2.3-Fast
使用该模型时,first_frame_image 参数必须上传
boolean
默认值:"true"
是否自动优化 prompt启用后,系统会自动优化您的提示词以获得更好的生成效果默认值:true
boolean
默认值:"false"
是否缩短 prompt 优化耗时启用后可加快处理速度,但可能略微影响优化效果默认值:false
boolean
默认值:"false"
是否添加水印默认值:false

分辨率与时长组合

运镜指令

prompt 中使用 [指令] 语法控制运镜效果,支持以下 15 种指令: 使用示例

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:快速生成文本视频

场景 2:生成高质量 1080p 视频

场景 3:指定首帧图片生成视频

场景 4:使用运镜指令

场景 5:快速预处理模式

查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。