MiniMax modeli | API Belgeleri

# 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 ortak Chat Completions uç noktasında akışsız ve SSE akışlı metin yanıtlarıyla kullanılabilir.

text

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

Kullanılabilir model

`model` değeri	Tür	Akışsız	SSE akışı
`minimax-m3`	Metin sohbeti	Evet	Evet

Kimlik doğrulama

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Akışsız istek

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
}

Akış isteği

json

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

Bu uç nokta varsayılan olarak tek bir tam JSON yanıtı döndürür. SSE akışı gerektiğinde stream: true değerini açıkça ayarlayın.

İstek alanları

modelstringzorunlu

minimax-m3 kullanın.

messagesobject[]zorunlu

OpenAI Chat Completions tarzı mesajlar. Her mesaj role ve content içerir.

streambooleanVarsayılan: false

true SSE döndürür; false tek bir tam JSON yanıtı döndürür.

max_tokensinteger

Pozitif tamsayı olarak isteğe bağlı azami çıktı tokenı. Seçilen modelin üst sağlayıcı varsayılanını kullanmak için atlayın. Modele göre bütçe, akıl yürütme tokenlarını ve son metni kapsayabilir. Küçük bütçe yanıtı kesebilir veya son metinden önce tükenebilir; artırmak maliyeti yükseltebilir.

max_completion_tokensinteger

Aynı bütçe hususlarıyla max_tokens için isteğe bağlı uyumluluk alternatifi. Desteği seçilen model belirler; üst varsayılanı kullanmak için iki alanı da atlayın.

thinkingobject

MiniMax akıl yürütme kontrolü. Gizli akıl yürütme gerektirmeyen kısa, doğrudan yanıtlar için { "type": "disabled" } kullanın. Varsayılan düşünme davranışını korumak için alanı atlayın.

temperature, top_p, frequency_penalty, presence_penalty, stop ve n gibi ortak alanlar için Ortak Chat Completions belgesine bakın. minimax-m3 bu standart alanları kabul eder; ancak her parametre mutlaka ölçülebilir anlamsal değişim yaratmaz.

Başarılı yanıt

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 isteğe bağlı önbellek girdisi veya akıl yürütme tokenı ayrıntıları içerebilir. Hesaplama ve telemetride standart girdi, çıktı ve toplam token alanlarını temel almaya devam edin.

Kullanım notları

Güncel açık sözleşme, akışsız ve SSE akışlı Chat Completions’tır.
minimax-m3 şu anda OpenAI Responses veya Claude Messages modeli olarak yayımlanmamıştır.
Tam olarak minimax-m3 kullanın.
Mevcut anahtara görünen modeller için GET https://api.apihop.ai/v1/models, güncel fiyatlar için konsolu kullanın.