feat: Add Minimax M2 model support (#3404)

Co-authored-by: Tao Sun <[email protected]>
Co-authored-by: Sun Tao <[email protected]>
Co-authored-by: Saed Bhati <[email protected]>
Co-authored-by: JINO ROHIT <[email protected]>
Co-authored-by: Wendong-Fan <[email protected]>

Author: 5 people

.github/workflows/build_package.yml

@@ -144,6 +144,7 @@ jobs:
           QIANFAN_API_KEY: "${{ secrets.QIANFAN_API_KEY }}"
           ACI_API_KEY: "${{ secrets.ACI_API_KEY }}"
           BOHRIUM_API_KEY: "${{ secrets.BOHRIUM_API_KEY }}"
+          MINIMAX_API_KEY: "${{ secrets.MINIMAX_API_KEY}}"
           CRYNUX_API_KEY: "${{ secrets.CRYNUX_API_KEY }}"
           NEBIUS_API_KEY: "${{ secrets.NEBIUS_API_KEY }}"
           COMETAPI_KEY: "${{ secrets.COMETAPI_KEY }}"

.github/workflows/pytest_package.yml

@@ -90,6 +90,7 @@ jobs:
         CRYNUX_API_KEY: "${{ secrets.CRYNUX_API_KEY }}"
         NEBIUS_API_KEY: "${{ secrets.NEBIUS_API_KEY }}"
         COMETAPI_KEY: "${{ secrets.COMETAPI_KEY }}"
+        MINIMAX_API_KEY: "${{ secrets.MINIMAX_API_KEY }}"
       run: |
         source .venv/bin/activate
         uv pip install -e ".[all, dev, docs]"
@@ -177,6 +178,7 @@ jobs:
         NEBIUS_API_KEY: "${{ secrets.NEBIUS_API_KEY }}"
         AMD_API_KEY: "${{ secrets.AMD_API_KEY }}"
         COMETAPI_KEY: "${{ secrets.COMETAPI_KEY }}"
+        MINIMAX_API_KEY: "${{ secrets.MINIMAX_API_KEY }}"
       run: |
         source .venv/bin/activate
         uv pip install -e ".[all, dev, docs]"
@@ -262,6 +264,7 @@ jobs:
         NEBIUS_API_KEY: "${{ secrets.NEBIUS_API_KEY }}"
         AMD_API_KEY: "${{ secrets.AMD_API_KEY }}"
         COMETAPI_KEY: "${{ secrets.COMETAPI_KEY }}"
+        MINIMAX_API_KEY: "${{ secrets.MINIMAX_API_KEY }}"
       run: |
         source .venv/bin/activate
         uv pip install -e ".[all, dev, docs]"

camel/configs/__init__.py

@@ -26,6 +26,7 @@
 from .internlm_config import INTERNLM_API_PARAMS, InternLMConfig
 from .litellm_config import LITELLM_API_PARAMS, LiteLLMConfig
 from .lmstudio_config import LMSTUDIO_API_PARAMS, LMStudioConfig
+from .minimax_config import MINIMAX_API_PARAMS, MinimaxConfig
 from .mistral_config import MISTRAL_API_PARAMS, MistralConfig
 from .modelscope_config import MODELSCOPE_API_PARAMS, ModelScopeConfig
 from .moonshot_config import MOONSHOT_API_PARAMS, MoonshotConfig
@@ -124,6 +125,8 @@
     'OPENROUTER_API_PARAMS',
     'LMSTUDIO_API_PARAMS',
     'LMStudioConfig',
+    'MINIMAX_API_PARAMS',
+    'MinimaxConfig',
     'WatsonXConfig',
     'WATSONX_API_PARAMS',
     'QianfanConfig',

camel/configs/minimax_config.py

@@ -0,0 +1,93 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+from __future__ import annotations
+
+from typing import Optional, Sequence, Union
+
+from camel.configs.base_config import BaseConfig
+
+
+class MinimaxConfig(BaseConfig):
+    r"""Defines the parameters for generating chat completions using OpenAI
+    compatibility with Minimax.
+
+    Reference: https://api.minimax.chat/document/guides/chat-model
+
+    Args:
+        temperature (float, optional): Sampling temperature to use, between
+            :obj:`0.0` and :obj:`1.0`. Higher values make the output more
+            random, while lower values make it more focused and deterministic.
+            Recommended to use :obj:`1.0`. Values outside this range will
+            return an error. (default: :obj:`None`)
+        top_p (float, optional): An alternative to sampling with temperature,
+            called nucleus sampling, where the model considers the results of
+            the tokens with top_p probability mass. So :obj:`0.1` means only
+            the tokens comprising the top 10% probability mass are considered.
+            (default: :obj:`None`)
+        n (int, optional): How many chat completion choices to generate for
+            each input message. Only supports value :obj:`1`.
+            (default: :obj:`None`)
+        response_format (object, optional): An object specifying the format
+            that the model must output. Setting to
+            {"type": "json_object"} enables JSON mode, which guarantees the
+            message the model generates is valid JSON. Important: when using
+            JSON mode, you must also instruct the model to produce JSON
+            yourself via a system or user message. Without this, the model
+            may generate an unending stream of whitespace until the generation
+            reaches the token limit, resulting in a long-running and seemingly
+            "stuck" request. Also note that the message content may be
+            partially cut off if finish_reason="length", which indicates the
+            generation exceeded max_tokens or the conversation exceeded the
+            max context length. (default: :obj:`None`)
+        stream (bool, optional): If set, partial message deltas will be sent,
+            like in ChatGPT. Tokens will be sent as data-only server-sent
+            events as they become available, with the stream terminated by
+            a data: [DONE] message. (default: :obj:`None`)
+        stop (str or list, optional): Up to :obj:`4` sequences where the API
+            will stop generating further tokens. (default: :obj:`None`)
+        max_tokens (int, optional): The maximum number of tokens to generate
+            in the chat completion. The total length of input tokens and
+            generated tokens is limited by the model's context length.
+            (default: :obj:`None`)
+        user (str, optional): A unique identifier representing your end-user,
+            which can help to monitor and detect abuse.
+            (default: :obj:`None`)
+        tool_choice (Union[dict[str, str], str], optional): Controls which (if
+            any) tool is called by the model. :obj:`"none"` means the model
+            will not call any tool and instead generates a message.
+            :obj:`"auto"` means the model can pick between generating a
+            message or calling one or more tools.  :obj:`"required"` means the
+            model must call one or more tools. Specifying a particular tool
+            via {"type": "function", "function": {"name": "my_function"}}
+            forces the model to call that tool. :obj:`"none"` is the default
+            when no tools are present. :obj:`"auto"` is the default if tools
+            are present.
+
+    Note:
+        Some OpenAI parameters such as presence_penalty, frequency_penalty,
+        and logit_bias will be ignored by Minimax.
+    """
+
+    temperature: Optional[float] = None
+    top_p: Optional[float] = None
+    n: Optional[int] = None
+    stream: Optional[bool] = None
+    stop: Optional[Union[str, Sequence[str]]] = None
+    max_tokens: Optional[int] = None
+    response_format: Optional[dict] = None
+    user: Optional[str] = None
+    tool_choice: Optional[Union[dict[str, str], str]] = None
+
+
+MINIMAX_API_PARAMS = {param for param in MinimaxConfig.model_fields.keys()}

camel/models/__init__.py

@@ -29,6 +29,7 @@
 from .internlm_model import InternLMModel
 from .litellm_model import LiteLLMModel
 from .lmstudio_model import LMStudioModel
+from .minimax_model import MinimaxModel
 from .mistral_model import MistralModel
 from .model_factory import ModelFactory
 from .model_manager import ModelManager, ModelProcessingError
@@ -104,6 +105,7 @@
     'SiliconFlowModel',
     'VolcanoModel',
     'LMStudioModel',
+    'MinimaxModel',
     'WatsonXModel',
     'QianfanModel',
     'CrynuxModel',

camel/models/minimax_model.py

@@ -0,0 +1,83 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+import os
+from typing import Any, Dict, Optional, Union
+
+from camel.configs import MinimaxConfig
+from camel.models.openai_compatible_model import OpenAICompatibleModel
+from camel.types import ModelType
+from camel.utils import (
+    BaseTokenCounter,
+    api_keys_required,
+)
+
+
+class MinimaxModel(OpenAICompatibleModel):
+    r"""LLM API served by Minimax in a unified OpenAICompatibleModel
+    interface.
+
+    Args:
+        model_type (Union[ModelType, str]): Model for which a backend is
+            created.
+        model_config_dict (Optional[Dict[str, Any]], optional): A dictionary
+            that will be fed into:obj:`openai.ChatCompletion.create()`.
+            If:obj:`None`, :obj:`MinimaxConfig().as_dict()` will be used.
+            (default: :obj:`None`)
+        api_key (Optional[str], optional): The API key for authenticating
+            with the Minimax service. (default: :obj:`None`).
+        url (Optional[str], optional): The url to the Minimax M2 service.
+            (default: :obj:`None`)
+        token_counter (Optional[BaseTokenCounter], optional): Token counter to
+            use for the model. If not provided, :obj:`OpenAITokenCounter(
+            ModelType.GPT_4O_MINI)` will be used.
+            (default: :obj:`None`)
+        timeout (Optional[float], optional): The timeout value in seconds for
+            API calls. If not provided, will fall back to the MODEL_TIMEOUT
+            environment variable or default to 180 seconds.
+            (default: :obj:`None`)
+        max_retries (int, optional): Maximum number of retries for API calls.
+            (default: :obj:`3`)
+        **kwargs (Any): Additional arguments to pass to the client
+            initialization.
+    """
+
+    @api_keys_required([("api_key", "MINIMAX_API_KEY")])
+    def __init__(
+        self,
+        model_type: Union[ModelType, str],
+        model_config_dict: Optional[Dict[str, Any]] = None,
+        api_key: Optional[str] = None,
+        url: Optional[str] = None,
+        token_counter: Optional[BaseTokenCounter] = None,
+        timeout: Optional[float] = None,
+        max_retries: int = 3,
+        **kwargs: Any,
+    ) -> None:
+        if model_config_dict is None:
+            model_config_dict = MinimaxConfig().as_dict()
+        api_key = api_key or os.environ.get("MINIMAX_API_KEY")
+        url = url or os.environ.get(
+            "MINIMAX_API_BASE_URL", "https://api.minimaxi.com/v1"
+        )
+        timeout = timeout or float(os.environ.get("MODEL_TIMEOUT", 180))
+        super().__init__(
+            model_type=model_type,
+            model_config_dict=model_config_dict,
+            api_key=api_key,
+            url=url,
+            token_counter=token_counter,
+            timeout=timeout,
+            max_retries=max_retries,
+            **kwargs,
+        )

camel/models/model_factory.py

@@ -31,6 +31,7 @@
 from camel.models.internlm_model import InternLMModel
 from camel.models.litellm_model import LiteLLMModel
 from camel.models.lmstudio_model import LMStudioModel
+from camel.models.minimax_model import MinimaxModel
 from camel.models.mistral_model import MistralModel
 from camel.models.modelscope_model import ModelScopeModel
 from camel.models.moonshot_model import MoonshotModel
@@ -91,6 +92,7 @@ class ModelFactory:
         ModelPlatformType.COMETAPI: CometAPIModel,
         ModelPlatformType.NEBIUS: NebiusModel,
         ModelPlatformType.LMSTUDIO: LMStudioModel,
+        ModelPlatformType.MINIMAX: MinimaxModel,
         ModelPlatformType.OPENROUTER: OpenRouterModel,
         ModelPlatformType.ZHIPU: ZhipuAIModel,
         ModelPlatformType.GEMINI: GeminiModel,

camel/types/enums.py

@@ -502,6 +502,10 @@ class ModelType(UnifiedModelType, Enum):
     CRYNUX_NOUS_HERMES_3_LLAMA_3_1_8B = "NousResearch/Hermes-3-Llama-3.1-8B"
     CRYNUX_NOUS_HERMES_3_LLAMA_3_2_3B = "NousResearch/Hermes-3-Llama-3.2-3B"
 
+    # Minimax M2 models
+    MINIMAX_M2 = "MiniMax-M2"
+    MINIMAX_M2_STABLE = "MiniMax-M2-Stable"
+
     def __str__(self):
         return self.value
 
@@ -1554,6 +1558,11 @@ def token_limit(self) -> int:
             ModelType.TOGETHER_LLAMA_4_SCOUT,
         }:
             return 10_000_000
+        elif self in {
+            ModelType.MINIMAX_M2,
+            ModelType.MINIMAX_M2_STABLE,
+        }:
+            return 32_000
 
         else:
             logger.warning(
@@ -1787,6 +1796,7 @@ class ModelPlatformType(Enum):
     QIANFAN = "qianfan"
     CRYNUX = "crynux"
     AIHUBMIX = "aihubmix"
+    MINIMAX = "minimax"
 
     @classmethod
     def from_name(cls, name):
@@ -1972,6 +1982,11 @@ def is_aihubmix(self) -> bool:
         r"""Returns whether this platform is AihubMix."""
         return self is ModelPlatformType.AIHUBMIX
 
+    @property
+    def is_minimax(self) -> bool:
+        r"""Returns whether this platform is Minimax M2."""
+        return self is ModelPlatformType.MINIMAX
+
 
 class AudioModelType(Enum):
     TTS_1 = "tts-1"

camel/types/unified_model_type.py

@@ -195,6 +195,11 @@ def is_crynux(self) -> bool:
         r"""Returns whether the model is a Crynux served model."""
         return True
 
+    @property
+    def is_minimax(self) -> bool:
+        r"""Returns whether the model is a Minimax served model."""
+        return True
+
     @property
     def support_native_structured_output(self) -> bool:
         r"""Returns whether the model supports native structured output."""

docs/mintlify/key_modules/models.mdx

@@ -52,6 +52,7 @@ CAMEL supports a wide range of models, including [OpenAI’s GPT series](https:/
 | **Reka**         | reka-core, reka-flash, reka-edge |
 | **COHERE**       | command-r-plus, command-r, command-light, command, command-nightly |
 | **ERNIE**        | ernie-x1-turbo-32k, ernie-x1-32k, ernie-x1-32k-preview<br/>ernie-4.5-turbo-128k, ernie-4.5-turbo-32k<br/>deepseek-v3, deepseek-r1, qwen3-235b-a22b |
+| **MiniMax**      | MiniMax-M2, MiniMax-M2-Stable |
 
 
 ### API & Connector Platforms