【对外】minimax-hailuo 接口文档_海外
输入“/”快速插入内容
【对外】minimax-hailuo 接口文档_海外
【对外】minimax-hailuo 接口文档_海外
用户2208用户2208
用户4607用户46072025年12月31日修改
模型计费
按照 次 收费，和分辨率、生成视频时长相关，具体计费如下：
模型id | 分辨率 | 时长 | 计费详情（$/次） |
minimax-hailuo-2.3-Fast | 768P | 6s | 0.19 |
| 768P | 10s | 0.32 |
| 1080P | 6s | 0.33 |
minimax-hailuo-2.3 | 768P | 6s | 0.28 |
| 768P | 10s | 0.56 |
| 1080P | 6s | 0.49 |
minimax-hailuo-02 | 512P | 6s | 0.10 |
| 512P | 10s | 0.15 |
| 768P | 6s | 0.28 |
| 768P | 10s | 0.56 |
| 1080P | 6s | 0.49 |
创建视频任务
接口请求
传输方式 | https |
请求地址 | |
调用方式 | 异步调用，需通过查询接口获取结果 |
字符编码 | UTF-8 |
接口请求格式 | JSON |
响应格式 | JSON |
接口请求类型 | POST |
请求参数
参数名 | 类型 | 是否必填 | 备注 |
model | string | 必填 | 服务标识 取固定值: minimax-hailuo-2.3、minimax-hailuo-2.3-fast，minimax-hailuo-02 |
prompt | string | 必填 | 生成视频的描述。最大支持2000字符。对prompt中的运镜控制，有更准确的响应。 一、支持插入运镜指令，实现运镜控制：运镜指令需以[ ]格式插入prompt中镜头应用处，标准运镜指令格式为[C1,C2,C3]，其中C表示不同类型运镜，共支持15种枚举运镜方式，具体可参考下方详情。为保证运镜效果，建议组合运镜指令不超过3个。 1、支持15种运镜方式（枚举值） （1） 左右移：[左移]、[右移] （2）左右摇：[左摇]、[右摇] （3）推拉：[推进]、[拉远] （4）升降：[上升]、[下降] （5）上下摇：[上摇]、[下摇] （6）变焦：[变焦推近]、[变焦拉远] （7）晃动：[晃动] （8）跟随：[跟随] （9）固定：[固定] 2、支持单一及组合运镜 （1）单一运镜：例如[左摇]，表示插入单一镜头； （2）多运镜同时生效：同一组内的镜头表示同时生效，如[左摇,右移]，表示插入两个组合镜头，且同时生效； （3）多运镜先后生效：插入在前的镜头指令，先生效。如在prompt描述“xxx[左摇]，xxx[右移] ” 表示：视频生成时，先运行左摇镜头，后运行右移镜头； 二、支持通过自然语言描述，实现运镜控制；使用指令内运镜名称，会提升运镜响应准确性。 三、 运镜指令与自然语言描述可同时生效。 minimax-hailuo-2.3-fast不支持文生视频 |
prompt_optimizer | boolean | 可选 | 默认取值为True，模型会自动优化传入的prompt，以提升生成质量。如果需要更精确的控制，可以将此参数设置为False，模型将更加严格地遵循指令。此时建议提供更精细的prompt，以获得最佳效果。 |
fast_pretreatment | bool | 可选 | 此参数打开后可以缩短“prompt_optimizer”优化prompt阶段消耗的时长。此参数仅对minimax-hailuo-2.3、minimax-hailuo-2.3-fast生效。 |
duration | int | 可选 | 生成视频时长，单位秒（s)。枚举值：6，10，默认值为6 • 768P: 默认6, 可选值：6, 10 • 1080P: 默认6, 可选值：6 |
resolution | string | 可选 | 生成视频的分辨率： 6s时长：默认值768P，可选值: 768P, 1080P； 10s时长：默认值768P，可选值: 768P。 |
first_frame_image | string | 可选 | 若分辨率选择为768P和1080P，则为选填参数。 模型将以此参数中传入的图片为首帧画面来生成视频。支持传入图片的data:image/jpeg;base64,{data}格式的 Base64 编码字符串，或可通过公网访问的 URL。传入此参数时支持将prompt设置为空字符串或不传入prompt，模型将自主决定画面如何演变。 传入图片需要满足以下条件： • 格式为JPG/JPEG/PNG/WebP； • 长宽比大于2:5、小于5:2； • 短边像素大于300px； • 体积不大于20mB。 |