Modelo MiniMax | Documentação de APIs

# 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 está disponível pelo endpoint Chat Completions comum, com respostas de texto sem streaming e com streaming SSE.

text

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

Modelo disponível

Valor de `model`	Tipo	Sem streaming	Streaming SSE
`minimax-m3`	Chat de texto	Sim	Sim

Autenticação

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Solicitação sem 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
}

Solicitação com streaming

json

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

Este endpoint retorna uma resposta JSON completa por padrão. Defina stream: true explicitamente quando precisar de streaming SSE.

Campos da solicitação

modelstringobrigatório

Use minimax-m3.

messagesobject[]obrigatório

Mensagens no estilo OpenAI Chat Completions. Cada mensagem contém role e content.

streambooleanPadrão: false

true retorna SSE; false retorna uma resposta JSON completa.

max_tokensinteger

Máximo opcional de tokens de saída, como inteiro positivo. Omita para usar o padrão do provedor para o modelo escolhido. Dependendo do modelo, o orçamento pode incluir tokens de raciocínio e texto final. Um orçamento pequeno pode truncar a resposta ou acabar antes do texto final; aumentá-lo pode elevar o custo.

max_completion_tokensinteger

Alternativa opcional de compatibilidade a max_tokens, com as mesmas considerações de orçamento. O modelo escolhido determina o suporte; omita ambos os campos para usar o padrão do provedor.

thinkingobject

Controle de raciocínio MiniMax. Use { "type": "disabled" } para respostas curtas e diretas sem necessidade de raciocínio oculto. Omita para manter o comportamento padrão do modelo.

Consulte Chat Completions comum para campos compartilhados como temperature, top_p, frequency_penalty, presence_penalty, stop e n. minimax-m3 aceita esses campos padrão, mas nem todo parâmetro necessariamente produz uma mudança semântica mensurável.

Resposta bem-sucedida

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 pode incluir detalhes opcionais de entrada em cache ou tokens de raciocínio. Continue baseando contabilidade e telemetria nos campos padrão de tokens de entrada, saída e totais.

Notas de uso

O contrato público atual é Chat Completions, sem streaming e com streaming SSE.
minimax-m3 não está publicado atualmente como modelo OpenAI Responses ou Claude Messages.
Use exatamente minimax-m3.
Use GET https://api.apihop.ai/v1/models para modelos visíveis à chave atual e o console para preços atuais.