MiniMax-Hailuo 图片接口

MiniMax-Hailuo 图片生成接口文档。

接口地址

POST https://www.moyu.info/v1/images/generations

请求示例

注意事项

⚠️ Windows 环境下 curl JSON 引号问题

在 Windows/Git Bash 环境下使用 curl 时，JSON数据的引号格式很重要：

❌ 错误写法：-d "{\"model\": \"...\"}"（双引号包裹，需要转义）

✅ 正确写法：-d '{"model": "..."}'（单引号包裹，无需转义）

使用单引号包裹JSON可以避免转义字符被错误处理。

cURL

其他语言

响应格式

成功响应

{
  "id": "05ede82792620ce1864e440c0190fd39",
  "data": {
    "image_urls": [
      "http://hailuo-image-algeng-data-us.oss-us-east-1.aliyuncs.com/image_inference_output/talkie/prod/img/2026-02-25/e7b022c0-383f-42ac-a11f-b4a5aae297f6_aigc.jpeg?Expires=1772095156&OSSAccessKeyId=LTAI5tRDTcyEYLLuBEpJRwCi&Signature=LJ5tfg%2B%2BEozsDAIp0nPgjSEEDm8%3D"
    ]
  },
  "metadata": {
    "failed_count": "0",
    "success_count": "1"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 0,
    "total_tokens": 1
  }
}

说明：上游 MiniMax 原生结构（id / data.image_urls / metadata / base_resp）会原样透传，判断成功请读 base_resp.status_code == 0。平台会在响应顶层额外注入一个 usage 字段（供成本核算），不影响原有字段解析。

错误响应

{
  "id": "05ede69bc84260c4c26a8e76b8489a59",
  "data": null,
  "base_resp": {
    "status_code": 1000,
    "status_msg": "unknown error"
  }
}

请求参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称，可选 `MiniMax-Hailuo-image-01` 或 `MiniMax-Hailuo-image-01-live`
prompt	string	是	-	图片描述提示词，描述想要生成的图片内容
aspect_ratio	string	否	1:1	图片宽高比，支持：`1:1`、`16:9`、`9:16`、`4:3`、`3:4` 等

响应字段说明

字段	类型	说明
id	string	请求的唯一标识符
data	object	生成结果数据
data.image_urls	array	生成的图片URL列表，带签名的临时链接
metadata	object	元数据信息
metadata.failed_count	string	失败的图片数量
metadata.success_count	string	成功生成的图片数量
base_resp	object	基础响应信息
base_resp.status_code	integer	状态码，`0` 表示成功，其他值表示错误
base_resp.status_msg	string	状态消息，如 `success` 或错误描述
usage	object	平台注入的用量信息（`prompt_tokens` / `completion_tokens` / `total_tokens`），非上游原生字段

完整示例

生成不同比例的图片

16:9 横向图片

9:16 竖向图片

1:1 正方形图片（默认）

错误处理

常见错误

认证失败

{
  "base_resp": {
    "status_code": 1001,
    "status_msg": "authentication failed"
  }
}

解决方案：检查API Key是否正确，确保 Authorization header 格式为 Bearer YOUR_API_KEY

请求参数错误

{
  "base_resp": {
    "status_code": 1000,
    "status_msg": "unknown error"
  }
}

解决方案：

检查模型名称是否为 MiniMax-Hailuo-image-01 或 MiniMax-Hailuo-image-01-live

检查 aspect_ratio 是否使用支持的值

确保 JSON 格式正确

提示词不合规

{
  "base_resp": {
    "status_code": 1002,
    "status_msg": "prompt contains inappropriate content"
  }
}

解决方案：修改提示词，避免使用违规或敏感内容

最佳实践

1. Prompt 编写建议

具体描述：提供详细的场景、风格、光线等描述

使用英文：模型对英文提示词的理解更准确

避免模糊词汇：使用具体的形容词而非模糊的"好看"、"漂亮"等

示例：

❌ "A beautiful picture"

✅ "A serene Japanese garden with cherry blossoms, stone lanterns, and a koi pond, soft morning light, photorealistic style"

2. 选择合适的宽高比

16:9：适合风景、场景、横幅图片

9:16：适合人物肖像、手机壁纸

1:1：适合社交媒体头像、产品图

4:3 / 3:4：传统照片比例

3. 图片URL处理

生成的图片URL是带签名的临时链接（OSS），建议：

立即下载保存图片

不要长期依赖该URL（可能会过期）

如需持久化，请将图片保存到自己的存储服务

4. Python 下载图片示例

Windows 环境 curl 使用说明

问题说明

在 Windows/Git Bash 环境下使用 curl 时，JSON 数据的引号格式非常重要。如果使用双引号包裹 JSON 并对内部引号进行转义（如 "{\"key\": \"value\"}"），可能导致转义字符处理错误。

替代方案

如果遇到引号问题，可以使用文件方式：

接口地址

请求示例

注意事项

cURL

其他语言

响应格式

成功响应

错误响应

请求参数

响应字段说明

完整示例

生成不同比例的图片

16:9 横向图片

9:16 竖向图片

1:1 正方形图片（默认）

错误处理

常见错误

最佳实践

1. Prompt 编写建议

2. 选择合适的宽高比

3. 图片URL处理

4. Python 下载图片示例

Windows 环境 curl 使用说明

问题说明

推荐做法

替代方案

相关资源

MiniMax-Hailuo 图片接口

接口地址#

请求示例#

注意事项#

cURL#

其他语言#

响应格式#

成功响应#

错误响应#

请求参数#

响应字段说明#

完整示例#

生成不同比例的图片#

16:9 横向图片#

9:16 竖向图片#

1:1 正方形图片（默认）#

错误处理#

常见错误#

最佳实践#

1. Prompt 编写建议#

2. 选择合适的宽高比#

3. 图片URL处理#

4. Python 下载图片示例#

Windows 环境 curl 使用说明#

问题说明#

推荐做法#

替代方案#

相关资源#

接口地址

请求示例

注意事项

cURL

其他语言

响应格式

成功响应

错误响应

请求参数

响应字段说明

完整示例

生成不同比例的图片

16:9 横向图片

9:16 竖向图片

1:1 正方形图片（默认）

错误处理

常见错误

最佳实践

1. Prompt 编写建议

2. 选择合适的宽高比

3. 图片URL处理

4. Python 下载图片示例

Windows 环境 curl 使用说明

问题说明

推荐做法

替代方案

相关资源