MiniMax 모델 | 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는 공통 Chat Completions 엔드포인트에서 비스트리밍 및 SSE 스트리밍 텍스트 응답을 제공합니다.

text

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

사용 가능한 개별 모델

`model` 값	유형	비스트리밍	SSE 스트리밍
`minimax-m3`	텍스트 채팅	지원	지원

인증

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

비스트리밍 요청

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
}

스트리밍 요청

json

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

이 엔드포인트는 기본적으로 하나의 완전한 JSON 응답을 반환합니다. SSE 스트리밍이 필요하면 stream: true를 명시하세요.

요청 필드

modelstring필수

minimax-m3을(를) 사용하세요.

messagesobject[]필수

OpenAI Chat Completions 형식의 메시지입니다. 각 메시지는 role과 content를 포함합니다.

streamboolean기본값: false

true는 SSE를, false는 하나의 완전한 JSON 응답을 반환합니다.

max_tokensinteger

양의 정수로 지정하는 선택적 최대 출력 토큰입니다. 생략하면 선택한 모델의 상위 제공자 기본값을 사용합니다. 모델에 따라 추론 토큰과 최종 텍스트가 같은 한도를 사용할 수 있습니다. 작은 한도는 응답을 자르거나 최종 텍스트 전에 소진될 수 있으며, 늘리면 비용이 증가할 수 있습니다.

max_completion_tokensinteger

max_tokens의 선택적 호환 대안으로 같은 한도 고려 사항이 적용됩니다. 지원 여부는 선택한 모델에 달려 있습니다. 둘 다 생략하면 상위 기본값을 사용합니다.

thinkingobject

MiniMax 추론 제어입니다. 숨겨진 추론이 필요 없는 짧고 직접적인 답변에는 { "type": "disabled" }를 사용하세요. 생략하면 모델 기본 추론 동작을 유지합니다.

temperature, top_p, frequency_penalty, presence_penalty, stop, n 같은 공통 필드는 공통 Chat Completions를 참조하세요. minimax-m3는 이 표준 필드를 받지만 모든 매개변수가 반드시 측정 가능한 의미 변화를 만드는 것은 아닙니다.

성공 응답

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에 선택적인 캐시 입력 또는 추론 토큰 상세 정보가 포함될 수 있습니다. 계산과 원격 측정은 계속 표준 입력, 출력 및 총 토큰 필드에 근거해야 합니다.

사용 참고 사항

현재 공개 계약은 비스트리밍 및 SSE 스트리밍을 포함한 Chat Completions입니다.
minimax-m3는 현재 OpenAI Responses나 Claude Messages 모델로 공개되지 않았습니다.
정확히 minimax-m3를 사용하세요.
현재 키에 보이는 모델은 GET https://api.apihop.ai/v1/models로, 현재 가격은 콘솔에서 확인하세요.