MiniMax API 文档
minimax2api 对外暴露的接口。网关地址在「连接设置」里配置;调用需要客户端密钥(见「密钥」页)。
对话
POST
/v1/chat/completions对话补全
所有模型类型都从这个口进(文本、图像、视频模型共用),OpenAI 格式,支持流式与非流式。
{
"model": "minimax-m3",
"messages": [{"role": "user", "content": "你好"}],
"stream": true
}{
"id": "chatcmpl-...",
"object": "chat.completion.chunk",
"choices": [{"index": 0, "delta": {"content": "你好"}}]
}| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 见「模型」页,列表里的每个 id 都能用 |
| messages | array | 是 | OpenAI 消息格式 |
| stream | boolean | 否 | true 为 SSE 流式 |
| reasoning_effort | string | 否 | 思考档位,low / medium / high / extended |
GET
/v1/models模型列表
返回网关暴露的全部模型 id。OpenAI 的 schema 没有字段能表达「这是图像模型」,客户端会把每个 id 都当对话模型,所以原则是列出来的就能用。
{
"object": "list",
"data": [{"id": "minimax-m3", "object": "model"}]
}图像
POST
/v1/images/generations图像生成
图像模型(minimax-image)走这个口,OpenAI 兼容格式。
{
"model": "minimax-image",
"prompt": "一只猫在弹钢琴",
"n": 1
}{
"created": 1793000000,
"data": [{"b64_json": "..."}]
}| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | minimax-image |
| prompt | string | 是 | 提示词 |
| n | integer | 否 | 生成张数 |
视频
POST
/v1/videos/generations视频生成
视频模型走这个口。minimax-h3-max 约 20 秒完成,是唯一能同步返回的。
{
"model": "minimax-h3-max",
"prompt": "一只猫在弹钢琴"
}| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | minimax-h3 / minimax-h3-max / minimax-hailuo-2-3 |
| prompt | string | 是 | 提示词 |
文件
POST
/v1/files文件上传
上传文件到网关,用于后续对话里引用文件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | multipart | 是 | 文件字段 |
系统
GET
/health健康检查
返回网关与账号池的存活状态。
{"ok": true}