Model MiniMax | Dokumentasi API

# MiniMax Model

Call MiniMax M3 through the shared Chat Completions endpoint.

POST https://api.apihop.ai/v1/chat-completions

MiniMax M3 is available through the Common Chat Completions endpoint, with both non-streaming and SSE streaming text responses.

```text
POST https://api.apihop.ai/v1/chat-completions
```

## Available Model

| `model` value | Type | Non-streaming | SSE streaming |
| --- | --- | --- | --- |
| `minimax-m3` | Text chat | Yes | Yes |

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Non-streaming Request

```json
{
  "model": "minimax-m3",
  "messages": [
    {
      "role": "system",
      "content": "You are a code review assistant."
    },
    {
      "role": "user",
      "content": "List five risk areas to review in a payment webhook implementation."
    }
  ],
  "thinking": {
    "type": "disabled"
  },
  "stream": false
}
```

## Streaming Request

```json
{
  "model": "minimax-m3",
  "messages": [
    {
      "role": "user",
      "content": "Analyze a duplicate queue-consumption issue step by step."
    }
  ],
  "stream": true
}
```

This endpoint returns one complete JSON response by default. Set `stream: true` explicitly when you need SSE streaming.

## Request Fields

### `model` (string, required)

Use `minimax-m3`.

### `messages` (object[], required)

OpenAI Chat Completions style messages. Each message contains `role` and `content`.

### `stream` (boolean, Default: false)

`true` returns SSE; `false` returns one complete JSON response.

### `max_tokens` (integer)

Optional maximum output tokens, as a positive integer. Omit this field to use the upstream default for the selected model. Depending on the model, the budget may include reasoning tokens as well as final text. A small budget can truncate the answer or be exhausted before final text; increasing it may increase cost.

### `max_completion_tokens` (integer)

Optional compatibility alternative to `max_tokens`, with the same budget considerations. The selected model determines support; omit both fields to use the upstream default.

### `thinking` (object)

MiniMax thinking control. Use `{ "type": "disabled" }` for short, direct answers that do not need hidden reasoning. Omit the field to keep the model's default thinking behavior.

See [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions) for shared fields such as `temperature`, `top_p`, `frequency_penalty`, `presence_penalty`, `stop`, and `n`. `minimax-m3` accepts these standard fields, but not every parameter necessarily produces a measurable semantic change.

## Success Response

```json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "minimax-m3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Start by checking idempotency keys, acknowledgements, and retry policy..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 29,
    "completion_tokens": 104,
    "total_tokens": 133
  }
}
```

`usage` may include optional cached-input or reasoning-token details. Continue to base accounting and telemetry on the standard input, output, and total token fields.

## Usage Notes

- The current public contract is Chat Completions, including non-streaming and SSE streaming.
- `minimax-m3` is not currently published as an OpenAI Responses or Claude Messages model.
- Use `minimax-m3` exactly.
- Use `GET https://api.apihop.ai/v1/models` for the models visible to the current API Key, and use the console for current pricing.

## Related Docs

- [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions)
- [Model Catalog](https://apihop.ai/en/docs/api-reference/models)

MiniMax M3 tersedia melalui endpoint Chat Completions bersama, dengan respons teks tanpa streaming maupun streaming SSE.

text

POST https://api.apihop.ai/v1/chat-completions

Model yang Tersedia

Nilai `model`	Jenis	Tanpa streaming	Streaming SSE
`minimax-m3`	Percakapan teks	Ya	Ya

Autentikasi

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Permintaan Tanpa Streaming

json

{
  "model": "minimax-m3",
  "messages": [
    {
      "role": "system",
      "content": "You are a code review assistant."
    },
    {
      "role": "user",
      "content": "List five risk areas to review in a payment webhook implementation."
    }
  ],
  "thinking": {
    "type": "disabled"
  },
  "stream": false
}

Permintaan Streaming

json

{
  "model": "minimax-m3",
  "messages": [
    {
      "role": "user",
      "content": "Analyze a duplicate queue-consumption issue step by step."
    }
  ],
  "stream": true
}

Secara bawaan, endpoint ini mengembalikan satu respons JSON lengkap. Tetapkan stream: true secara eksplisit jika memerlukan streaming SSE.

Kolom Permintaan

modelstringwajib

Gunakan minimax-m3.

messagesobject[]wajib

Pesan bergaya OpenAI Chat Completions. Setiap pesan berisi role dan content.

streambooleanBawaan: false

true mengembalikan SSE; false mengembalikan satu respons JSON lengkap.

max_tokensinteger

Batas maksimum token output opsional, berupa bilangan bulat positif. Hilangkan kolom ini untuk menggunakan nilai bawaan penyedia hulu bagi model yang dipilih. Bergantung pada model, anggaran ini dapat mencakup token penalaran dan teks akhir. Anggaran kecil dapat memotong jawaban atau habis sebelum teks akhir dihasilkan; menaikkannya dapat meningkatkan biaya.

max_completion_tokensinteger

Alternatif kompatibilitas opsional untuk max_tokens, dengan pertimbangan anggaran yang sama. Dukungan ditentukan oleh model yang dipilih; hilangkan kedua kolom untuk menggunakan nilai bawaan penyedia hulu.

thinkingobject

Kontrol penalaran MiniMax. Gunakan { "type": "disabled" } untuk jawaban singkat dan langsung yang tidak memerlukan penalaran tersembunyi. Hilangkan kolom ini untuk mempertahankan perilaku penalaran bawaan model.

Lihat Chat Completions Bersama untuk kolom bersama seperti temperature, top_p, frequency_penalty, presence_penalty, stop, dan n. minimax-m3 menerima kolom standar ini, tetapi tidak setiap parameter selalu menghasilkan perubahan semantik yang terukur.

Respons Berhasil

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "minimax-m3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Start by checking idempotency keys, acknowledgements, and retry policy..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 29,
    "completion_tokens": 104,
    "total_tokens": 133
  }
}

usage dapat mencakup detail input cache atau token penalaran opsional. Tetap gunakan kolom standar token input, output, dan total sebagai dasar pencatatan biaya serta telemetri.

Catatan Penggunaan

Kontrak publik saat ini adalah Chat Completions, termasuk mode tanpa streaming dan streaming SSE.
minimax-m3 saat ini tidak dipublikasikan sebagai model OpenAI Responses atau Claude Messages.
Gunakan minimax-m3 persis seperti tertulis.
Gunakan GET https://api.apihop.ai/v1/models untuk melihat model yang tersedia bagi kunci API saat ini, dan gunakan konsol untuk harga terkini.