نموذج 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 كاملة واحدة افتراضيا. اضبط stream: true صراحة عندما تحتاج إلى بث SSE.

حقول الطلب

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" } لإجابات قصيرة ومباشرة لا تحتاج إلى استدلال خفي. احذف الحقل للإبقاء على سلوك التفكير الافتراضي للنموذج.

راجع واجهة Chat Completions المشتركة للحقول المشتركة مثل temperature وtop_p وfrequency_penalty وpresence_penalty وstop وn. يقبل 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 تفاصيل اختيارية للمدخلات المخزنة مؤقتا أو رموز الاستدلال. واصل بناء المحاسبة وقياسات التشغيل على الحقول القياسية لرموز المدخلات والمخرجات والإجمالي.

ملاحظات الاستخدام

العقد العام الحالي هو Chat Completions، بما فيه الوضع دون بث وبث SSE.
لا ينشر minimax-m3 حاليا كنموذج OpenAI Responses أو Claude Messages.
استخدم minimax-m3 بالضبط.
استخدم GET https://api.apihop.ai/v1/models للنماذج الظاهرة لمفتاح API الحالي، واستخدم وحدة التحكم للأسعار الحالية.