hailuo-2.3

Name: hailuo-2.3
Brand: MiniMax

视频

支持文生与图生视频，可输出 6-10 秒、768p/1080p 画面，支持精细运镜指令控制，运动流畅、主体稳定，适合短视频创意内容。

分辨率

1080p

768p

不含视频输入

10% 折扣

$1.764/ M

$2.016/ M

含视频输入

10% 折扣

$1.764/ M

$2.016/ M

输入

文本

输出

视频

输入

视频文案 *

视频时长（秒）分辨率精确尺寸宽高比

生成音频

随机种子设为 -1 表示随机，相同 seed 不保证完全一致

参考素材

可选，用于图生视频、首尾帧驱动、视频风格迁移或音频驱动生成。点击或拖拽上传本地文件。

填写尾帧时需同时提供首帧

首帧参考图

点击上传

尾帧参考图

点击上传

参考视频

点击上传

参考音频

点击上传

输出

API

快速开始

复制即用，通过 EasyAPI 的 OpenAI 兼容 API 调用本模型。

获取 API 令牌

在控制台创建 API 令牌，并设置为环境变量：

将 sk-xxxxxxxx 替换为控制台颁发的 API 令牌（Bearer Token）。

创建 API 令牌

shell

export EASYAPI_API_KEY=sk-xxxxxxxx

发起第一次请求

使用 minimax/hailuo-2.3 调用 EasyAPI：

cURL

curl https://token.easyapi.com/v1/videos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EASYAPI_API_KEY" \
  -d '{"model":"minimax/hailuo-2.3","prompt":"A golden retriever running on a sunny beach, cinematic camera movement","duration":5,"resolution":"720p","aspect_ratio":"adaptive","generate_audio":false,"seed":-1,"size":"1280x720","input_references":[{"type":"image","url":"https://cdn.example.com/portrait.jpg","role":"first_frame"}]}'

端点

根据提示词提交视频生成任务。

POSThttps://token.easyapi.com/v1/videos

Authorization: Bearer $EASYAPI_API_KEY
Content-Type: application/json
Model: minimax/hailuo-2.3

根据 prompt 提交视频生成任务，响应含任务 ID 或结果 URL。文档

参数

名称	类型	必选	说明
`model`	string	是	模型 ID，如 bytedance/seedance-2.0；当前使用 minimax/hailuo-2.3
`prompt`	string	是	视频描述，建议包含主体、动作、场景、镜头和风格。不同模型上限不同：Sora 500 字，Hailuo 2000 字，Wan T2V 1500 字、I2V 800 字。Gate.AI 本身不设硬性上限，超出后由上游拒绝并透传 502 / 503。
`duration`	integer	否	视频时长（秒），支持 4–15
`resolution`	string	否	输出分辨率：480p、720p 或 1080p
`aspect_ratio`	string	否	宽高比：16:9、4:3、1:1、3:4、9:16、21:9 或 adaptive
`generate_audio`	boolean	否	是否生成音频
`seed`	integer	否	随机种子，-1 到 4294967295；相同 seed 不保证完全一致
`size`	string	否	精确输出尺寸，如 1280x720
`input_references`	array	否	可选参考素材数组，用于图生视频、首尾帧驱动、视频风格迁移或音频驱动生成
`input_references[].type`	string	是	参考素材类型：image、video 或 audio，必须与 role 匹配
`input_references[].url`	string	是	参考素材的 HTTPS 地址
`input_references[].role`	string	是	参考素材用途：first_frame（首帧图）、last_frame（尾帧图）、reference（外观参考图）、reference_video（参考视频）、reference_audio（参考音频）
`metadata`	object	否	业务透传字段，用于审计或来源标记
`webhook_url`	string	否	任务完成或失败后的回调地址

使用第三方 SDK

OpenAI、Anthropic 等官方 SDK 均可通过替换 base_url 接入，详见标准接入文档

相关模型

hailuo-02

MiniMax

支持文生与图生视频，可输出 6-10 秒、512p/768p/1080p 多档画质，支持运镜指令控制，在画质与成本间灵活平衡。

视频

9折

分辨率	不含视频输入	含视频输入
1080p	$1.764/ M	$1.764/ M
512p	$0.54/ M	$0.54/ M
768p	$2.016/ M	$2.016/ M

minimax-m2.1

MiniMax

性价比导向的通用模型，在对话与内容生产任务中速度和质量较均衡。

文本

85折

输入价格

$0.2635/ M

输出价格

$1.0455/ M

缓存读

$0.0264/ M

缓存写

$0.3315/ M

minimax-m2.5-highspeed

MiniMax

M2.5 系列的加速版本，推理质量与标准版一致，吞吐约提升至三倍，主打编程与智能体工具调用，适合对延迟敏感的 Agent 交互与批量任务。

文本

85折

输入价格

$0.51/ M

输出价格

$2.04/ M

缓存读

$0.0255/ M

缓存写

$0.3187/ M

minimax-m2.7

MiniMax

多智能体协作模型，支持复杂任务规划与生产级工作流执行

文本

7折

输入价格

$0.2171/ M

输出价格

$0.8685/ M

缓存读

$0.0434/ M

缓存写

$0/ M