https://github.com/zients/minimax-sdk

SDKs for MiniMax APIs — Text, Speech, Video, Image, Music & Files
https://github.com/zients/minimax-sdk

ai image-generation llm minimax monorepo music-generation python sdk text-generation tts typescript video-generation

Last synced: 2 months ago
JSON representation

SDKs for MiniMax APIs — Text, Speech, Video, Image, Music & Files

• Host: GitHub
• URL: https://github.com/zients/minimax-sdk
• Owner: zients
• License: mit
• Created: 2026-03-18T12:18:40.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-03-22T16:31:04.000Z (3 months ago)
• Last Synced: 2026-03-23T02:31:39.156Z (3 months ago)
• Topics: ai, image-generation, llm, minimax, monorepo, music-generation, python, sdk, text-generation, tts, typescript, video-generation
• Language: Python
• Size: 160 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# MiniMax SDK

SDKs for MiniMax's multimodal APIs.

[![PyPI version](https://img.shields.io/pypi/v/zients-minimax-sdk.svg)](https://pypi.org/project/zients-minimax-sdk/)

[![npm version](https://img.shields.io/npm/v/@zients/minimax-sdk.svg)](https://www.npmjs.com/package/@zients/minimax-sdk)

[![Python](https://img.shields.io/pypi/pyversions/zients-minimax-sdk.svg)](https://pypi.org/project/zients-minimax-sdk/)

[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

## Supported APIs

| API | Capabilities |

|-----|-------------|

| Text | Chat completion, streaming, tool use, extended thinking (via Anthropic-compatible endpoint) |

| Speech | TTS (sync, streaming, WebSocket, async long-text) |

| Video | Text-to-video, image-to-video, first/last-frame, subject reference |

| Image | Text-to-image, image-to-image |

| Music | Generate, stream, lyrics |

| Voice | Clone, design, list, delete |

| Files | Upload, list, retrieve, download, delete |

## Language SDKs

| Language | Status | Path | Package |

|----------|--------|------|---------|

| Python | Available | [`python/`](python/) | [![PyPI](https://img.shields.io/pypi/v/zients-minimax-sdk.svg)](https://pypi.org/project/zients-minimax-sdk/) |

| TypeScript | Available | [`typescript/`](typescript/) | [![npm](https://img.shields.io/npm/v/@zients/minimax-sdk.svg)](https://www.npmjs.com/package/@zients/minimax-sdk) |

## Quick Start

### Python

```bash

pip install zients-minimax-sdk

```

```python

from minimax_sdk import MiniMax

client = MiniMax(api_key="your-api-key")

# Text generation

result = client.text.create(

    model="MiniMax-M2.7",

    messages=[{"role": "user", "content": "Hello"}],

    max_tokens=1024,

)

print(result.content[0].text)

# Text-to-Speech

audio = client.speech.tts(text="Hello world", model="speech-2.8-hd")

audio.save("hello.mp3")

```

See [python/README.md](python/README.md) for full documentation.

### TypeScript

```bash

npm install @zients/minimax-sdk

```

```typescript

import MiniMax from "@zients/minimax-sdk";

const client = new MiniMax({ apiKey: "your-api-key" });

// Text generation

const result = await client.text.create({

  model: "MiniMax-M2.7",

  messages: [{ role: "user", content: "Hello" }],

  maxTokens: 1024,

});

console.log(result.content[0].text);

// Text-to-Speech

const audio = await client.speech.tts({

  text: "Hello world",

  model: "speech-2.8-hd",

});

await audio.save("hello.mp3");

```

See [typescript/README.md](typescript/README.md) for full documentation.

## License

[MIT](LICENSE)