hailuo-02-pro (图生视频)

来源: https://docs.surgeai.one/docs/allapi/MiniMax/hailuo-02-pro/surgeai-format/image-to-video

图生视频 API 的 SurgeAI 格式。

身份验证

在 https://surgeai.one 注册 SurgeAI 账户

进入控制台的 API Keys 部分

生成新的 API key (sk-xxxxx)

复制并安全存储您的 API key

有关身份验证的详细信息，请参阅身份验证部分。

发起请求

查询结果

如果生成内容的请求包含参数 enable_sync_mode 设置为 true（某些模型不支持此参数，但您仍需要通过 id 查询结果），您必须调用查询结果端点来获取最终输出。

提交预测请求后，响应将包含您需要的 id。
您可以在以下位置找到它：

data.id – 预测的唯一标识符

data.urls[0].get – 一个现成的 GET URL，已嵌入 id

响应示例

{
  "data": {
    "id": "abc",
    "model": "model_name",
    "outputs": [],
    "urls": {
      "get": "https://surgeai.one/api/v3/predictions/abc/result"
    },
    "status": "completed",
    "error": null,
    "executionTime": 0,
    "timings": {
      "inference": 0
    },
    "has_nsfw_contents": [],
    "created_at": "2026-01-01 00:00:00"
  },
  "message": "success",
  "code": 200
}

参数

路径参数

端点: https://surgeai.one/api/v3/minimax/{model}/{scene}

scene	示例
`text-to-video`	`https://surgeai.one/api/v3/minimax/hailuo-02-fast/text-to-video`
`image-to-video`	`https://surgeai.one/api/v3/minimax/hailuo-02-fast/image-to-video`

请求体

参数	类型	必填	默认值	范围	描述
`prompt`	string	是	-	-	提示词参数
`image`	string	是（图生视频场景必填）	-	-	模型以传入的图片作为第一帧生成视频。支持 data:image/jpeg;base64 格式的 Base64 编码字符串，或公网可访问的 URL。上传的图片需满足以下条件：格式为 JPG/JPEG/PNG；宽高比大于 2:5 且小于 5:2；短边像素大于 300px；图片文件大小不超过 20MB。
`end_image`	string	否	-	-	模型以传入的图片作为最后一帧生成视频。支持 data:image/jpeg;base64 格式的 Base64 编码字符串，或公网可访问的 URL。上传的图片需满足以下条件：格式为 JPG/JPEG/PNG；宽高比大于 2:5 且小于 5:2；短边像素大于 300px；图片文件大小不超过 20MB。
`duration`	integer	否	`6`	`6`, `10`	生成媒体的时长（秒）。详见时长部分。
`resolution`	string	否	`768P`	`512P`, `720P`, `768P`, `1080P`	分辨率参数。详见分辨率部分。
`enable_prompt_expansion`	boolean	否	`true`	-	模型自动优化输入的提示词以增强输出质量。同时会激活安全检查器，通过检测和过滤潜在风险来确保内容安全。

时长

视频时长（秒），默认值为 6。可用值取决于模型和分辨率：

模型	720P	768P	1080P
MiniMax-Hailuo-2.3	-	`6` 或 `10`	`6`
MiniMax-Hailuo-2.3-Fast	-	`6` 或 `10`	`6`
MiniMax-Hailuo-02	-	`6` 或 `10`	`6`
其他模型	`6`	-	`6`

分辨率

视频分辨率。可用值取决于模型：

模型	6s	10s
MiniMax-Hailuo-2.3	`768P`（默认）, `1080P`	`768P`（默认）
MiniMax-Hailuo-2.3-Fast	`768P`（默认）, `1080P`	`768P`（默认）
MiniMax-Hailuo-02	`512P`, `768P`（默认）, `1080P`	`512P`, `768P`（默认）
其他模型	`720P`（默认）	不支持

错误码

常见错误码

错误码	错误名称	描述
401	Unauthorized	API key 缺失或无效
403	Forbidden	您的 API key 没有权限访问此资源，或余额不足
429	Too Many Requests	您已超出速率限制
500	Internal server error	发生内部服务器错误
503	Content policy violation	内容因安全问题被阻止（实际状态码为 400）

hailuo-02-pro (图生视频)

身份验证#

发起请求#

查询结果#

响应示例#

参数#

路径参数#

请求体#

时长#

分辨率#

错误码#

常见错误码#