# MiniMax API 认证方式

> 更新：2026-05-18（更正：GroupId 不是必需的）

## 统一认证方式

所有 MiniMax API 使用统一的认证方式：

```
Authorization: Bearer <Token Plan Key>
Content-Type: application/json
```

**无需 GroupId。** 所有 API 共用同一个 Token Plan Key（sk-cp-xxx）。

## 曾犯的错误

之前测试图片/音乐 API 时，curl 命令中使用了占位符 Key（`sk-cp-BdZxzkXXXXXXXXXXXXXX98jM`），导致返回 1004 login fail。错误信息说"请在 Authorization 字段携带 API secret key"，但实际上是因为 Key 本身就是假的。

用真实 Token Plan Key 测试后，文本/TTS/图片/音乐/歌词 全部成功：

| API | 状态 | Key |
|-----|------|-----|
| 文本对话 | ✅ 成功 | 真实 Key |
| TTS | ✅ 成功 | 真实 Key |
| 图片生成 | ✅ 成功 | 真实 Key |
| 音乐生成 | ✅ 成功 | 真实 Key |
| 歌词生成 | ✅ 成功 | 真实 Key |

## 1004 错误排查

返回 1004 时：

1. **确认 Key 是真实的 Token Plan Key（sk-cp-开头），不是占位符**
2. **确认 `Content-Type: application/json` header 已添加**
3. **确认 Authorization header 格式正确：`Bearer <key>`**

## 图片生成请求示例

```python
import requests

url = "https://api.minimaxi.com/v1/image_generation"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "model": "image-01",
    "prompt": "a cute cat",
    "aspect_ratio": "1:1"
}
resp = requests.post(url, headers=headers, json=payload)
```

## 音乐生成请求示例

```python
url = "https://api.minimaxi.com/v1/music_generation"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "model": "music-2.6",
    "prompt": "欢快的流行音乐",
    "lyrics": "[Verse]\n新年到\n..."
}
resp = requests.post(url, headers=headers, json=payload)
```

## 歌词生成请求示例

```python
url = "https://api.minimaxi.com/v1/lyrics_generation"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "mode": "write_full_song",
    "prompt": "一首关于夏日海边的轻快情歌"
}
resp = requests.post(url, headers=headers, json=payload)
```

## 所有已验证可用的 API

| API | 端点 | 模型 | 状态 |
|-----|------|------|------|
| 文本对话 | `/anthropic/v1/messages` | MiniMax-M2.7 | ✅ |
| TTS | `/v1/t2a_v2` | speech-2.8-hd | ✅ |
| 图片生成 | `/v1/image_generation` | image-01 | ✅ |
| 音乐生成 | `/v1/music_generation` | music-2.6 | ✅ |
| 歌词生成 | `/v1/lyrics_generation` | - | ✅ |
| Vision | M2.7 原生支持 | - | ✅ |