StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
整合指南
MiniMax-M2.5 - 完整参数文档
StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
文本系列MiniMaxMinimax.M2.5

MiniMax-M2.5 - 完整参数文档

  • 使用 OpenAI SDK 格式调用 MiniMax-M2.5 模型
  • 同步处理模式,实时返回对话内容
  • 纯文本对话:单轮或多轮上下文对话
  • 系统提示词:自定义 AI 的角色和行为
<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-M2.5>必填

对话模型名称

"MiniMax-M2.5"
messagesobject[]必填

对话消息列表,支持多轮对话

[
  {
    "role": "user",
    "content": "请介绍一下你自己"
  }
]
max_tokensinteger

指定生成内容长度的上限(Token 数),上限为 2048 **说明**: - 超过上限的内容会被截断 - 如果生成因 `length` 原因中断,请尝试调高此值

2048
streamboolean

是否以流式方式返回响应 - `true`: 流式返回,逐块实时返回内容 - `false`: 等待完整响应后一次性返回

false
temperaturenumber

采样温度,控制输出的随机性 **说明**: - 较低值(如 0.1): 更确定、更聚焦的输出 - 较高值(如 0.9): 更随机、更有创意的输出 - 取值范围: (0, 1],不包含 0

0.7
top_pnumber

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

0.9
enable_searchboolean

是否启用联网搜索 - `true`: 启用联网搜索,模型会根据需要搜索互联网获取最新信息 - `false`: 不启用联网搜索

true
search_optionsobject

联网搜索选项,需配合 `enable_search: true` 使用

{
  "search_strategy": "max"
}

回應

application/json
成功

回應體

idstring

对话完成的唯一标识符

"cmpl-04ea926191a14749b7f2c7a48a68abc6"
modelstring

实际使用的模型名称

"MiniMax-M2.5"
objectenum<chat.completion>

响应类型

"chat.completion"
createdinteger

创建时间戳

1698999496
choicesobject[]

对话生成的选择列表

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hi there! How can I help you?"
    },
    "finish_reason": "stop"
  }
]
usageobject

Token 使用统计信息

{
  "prompt_tokens": 8,
  "completion_tokens": 292,
  "total_tokens": 300
}
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-M2.5",
  "messages": [
    {
      "role": "user",
      "content": "请介绍一下你自己"
    }
  ]
}'
回應: 成功
{
  "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6",
  "model": "MiniMax-M2.5",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}