StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
整合指南
MiniMax-M3 - OpenAI-Compatible APIMiniMax-M3 - Anthropic-Compatible API
StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
文本系列MiniMaxMinimax.M3

MiniMax-M3 - OpenAI 兼容接口

  • 使用 OpenAI Chat Completions 协议调用 MiniMax-M3 模型
  • 多轮对话:支持单轮或多轮上下文对话
  • 系统提示词:通过 role=system 消息自定义 AI 的角色和行为
  • 多模态输入:content 支持文本 + 图像 / 视频混排
  • 思考模式:通过 thinking.type 控制;思考内容通过 reasoning_content 返回
  • 流式输出:支持 SSE 流式返回
  • 工具调用:支持 Function Calling
<Note> **BaseURL 说明**:默认 BaseURL 为 `https://api.starmagic.ai`,对文本模型支持更好,支持长连接;`https://api.starmagic.ai` 是多模态主力地址,对文本模型作为备用地址使用。 </Note>

授權

Authorizationstringheader必填

##所有接口均需要使用 Bearer Token 进行认证## **获取 API Key**: 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加**: ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

請求體

application/json
modelenum<MiniMax-M3>必填

对话模型名称

"MiniMax-M3"
messagesobject[]必填

对话消息列表,支持多轮对话 不同角色的消息具有不同的字段结构,请选择对应角色查看

[
  null
]
thinkingobject

控制深度思考 **说明**: - **默认 `adaptive`**:模型根据问题难度自适应决定是否进行深度思考 - 默认情况下思考内容会内联在回复 `content` 中(以 `<think>...</think>` 包裹);如需拆分到独立字段,请配合 `reasoning_split`

{
  "type": "adaptive"
}
reasoning_splitboolean

是否将思考内容拆分到独立字段 - `false`(默认):思考内容内联在 `content` 中,以 `<think>...</think>` 包裹 - `true`:思考内容拆分到 `choices[].message.reasoning_content` 与 `reasoning_details`

true
temperaturenumber

采样温度,控制输出的随机性 **说明**: - 较低值(如 0.2):更确定、更聚焦的输出 - 较高值(如 1.5):更随机、更有创意的输出 - 取值范围 `[0, 2]`,默认 1

1
top_pnumber

核采样(Nucleus Sampling)参数 **说明**: - 控制从累积概率前多少的 token 中采样 - 例如 0.95 表示从累积概率达到 95% 的 token 中选择 - 取值范围 `[0, 1]`,MiniMax-M3 默认 0.95 **建议**:不要同时调整 temperature 和 top_p

0.95
max_completion_tokensinteger

指定生成内容长度的上限(Token 数) **说明**: - MiniMax-M3 推荐 **131,072**(128K),上限 **524,288**(512K) - 思考产生的 token 也计入该上限 - 如果生成因 `length` 原因中断,请尝试调高此值

131072
streamboolean

是否以流式方式返回响应 - `true`:流式返回,通过 SSE(Server-Sent Events)逐块实时返回内容 - `false`:等待完整响应后一次性返回(默认)

false
stream_optionsobject

流式响应选项 仅在 `stream=true` 时有效

{
  "include_usage": true
}
toolsobject[]

工具定义列表,用于 Function Calling 每个工具需要定义名称、描述和参数 schema

[
  {
    "type": "function",
    "function": {
      "name": "string",
      "description": "string",
      "parameters": {}
    }
  }
]
max_tokensinteger

旧版生成长度限制参数 **说明**:已弃用,请改用 `max_completion_tokens`

0

回應

application/json
成功

回應體

idstring

对话完成的唯一标识符

"0668a381bdc3c0ded310e27c9a46d16e7"
modelstring

实际使用的模型名称

"MiniMax-M3"
objectenum<chat.completion>

响应类型

"chat.completion"
createdinteger

创建时间戳(Unix 秒)

1777026807
choicesobject[]

对话生成的选择列表

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好!我是 MiniMax-M3,可以帮你完成对话、写作、推理、代码等多种任务。",
      "reasoning_content": "让我分析一下这个问题...",
      "reasoning_details": [
        {
          "type": null,
          "id": null,
          "format": null,
          "index": null,
          "text": null
        }
      ],
      "name": "string",
      "audio_content": "string",
      "tool_calls": [
        {
          "id": null,
          "type": null,
          "function": null,
          "index": null
        }
      ]
    },
    "finish_reason": "stop"
  }
]
usageobject

Token 使用统计信息

{
  "total_tokens": 1604,
  "total_characters": 0,
  "prompt_tokens": 1365,
  "completion_tokens": 239,
  "prompt_tokens_details": {
    "cached_tokens": 114
  }
}
input_sensitiveboolean

输入内容是否命中敏感词。若输入严重违规,接口会返回内容违规错误,回复内容为空

true
input_sensitive_typeinteger

输入命中敏感词类型(`input_sensitive` 为 true 时返回):1 严重违规;2 色情;3 广告;4 违禁;5 谩骂;6 暴恐;7 其他

0
output_sensitiveboolean

输出内容是否命中敏感词

true
output_sensitive_typeinteger

输出命中敏感词类型

0
base_respobject

状态码和错误详情

{
  "status_code": 0,
  "status_msg": "string"
}
POST/v1/chat/completions
curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M3",
  "messages": [
    {
      "role": "user",
      "content": "请介绍一下你自己"
    }
  ]
}'
回應: 成功
{
  "id": "066b36619b147e326d17053cccdef70f",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "<think>\n用户问的是法国首都,这是常识性问题,直接给出答案巴黎即可。\n</think>\n法国的首都是**巴黎**。",
        "role": "assistant",
        "name": "MiniMax AI",
        "audio_content": ""
      }
    }
  ],
  "created": 1777026807,
  "model": "MiniMax-M3",
  "object": "chat.completion",
  "usage": {
    "total_tokens": 60,
    "total_characters": 0,
    "prompt_tokens": 7,
    "completion_tokens": 53,
    "prompt_tokens_details": {
      "cached_tokens": 0
    }
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "input_sensitive_type": 0,
  "output_sensitive_type": 0,
  "base_resp": {
    "status_code": 0,
    "status_msg": ""
  }
}