跳转到主要内容
POST
/
v1
/
text
/
chatcompletion_v2
curl --request POST \ --url https://api.minimaxi.com/v1/text/chatcompletion_v2 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: <content-type>' \ --data ' { "model": "MiniMax-M1", "messages": [ { "role": "system", "name": "MiniMax AI" }, { "role": "user", "name": "用户", "content": "你好" } ] } '
{
  "id": "04ecb5d9b1921ae0fb0e8da9017a5474",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "您好！请问有什么可以帮您？",
        "role": "assistant",
        "name": "MiniMax AI",
        "audio_content": "",
        "reasoning_content": "...省略"
      }
    }
  ],
  "created": 1755153113,
  "model": "MiniMax-M1",
  "object": "chat.completion",
  "usage": {
    "total_tokens": 249,
    "total_characters": 0,
    "prompt_tokens": 26,
    "completion_tokens": 223,
    "completion_tokens_details": {
      "reasoning_tokens": 214
    }
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "input_sensitive_type": 0,
  "output_sensitive_type": 0,
  "output_sensitive_int": 0,
  "base_resp": {
    "status_code": 0,
    "status_msg": ""
  }
}

授权

​
Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在 账户管理>接口密钥 中查看。

请求头

​
Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型，请设置为 application/json，确保请求数据的格式为 JSON

可用选项:
application/json

请求体

application/json
​
model
enum<string>
必填

模型 ID。可选值：MiniMax-M2.1, MiniMax-M2 。注：MiniMax-M2.1 和 MiniMax-M2 为推理模型，为获得最佳体验建议使用流式输出

可用选项:
MiniMax-M2.1,
MiniMax-M2
​
messages
object[]
必填

包含对话历史的消息列表

​
stream
boolean
默认值:false

是否使用流式传输，默认为 false。设置为 true 后，响应将分批返回

​
max_tokens
integer<int64>
已弃用

废弃参数，请使用max_completion_tokens

指定生成内容长度的上限（Token 数）。超过上限的内容会被截断。如果生成因 length 原因中断，请尝试调高此值 默认值：MiniMax-M2 为 10240，MiniMax-M1 为 8192，MiniMax-Text-01 为 2048

必填范围: x >= 1
​
max_completion_tokens
integer<int64>

指定生成内容长度的上限（Token 数）。超过上限的内容会被截断。如果生成因 length 原因中断，请尝试调高此值 默认值：MiniMax-M2 为 10240，MiniMax-M1 为 8192，MiniMax-Text-01 为 2048。

必填范围: x >= 1
​
temperature
number<double>

温度系数，影响输出随机性，取值范围 (0, 1]，取值范围 (0, 1]。值越高，输出越随机；值越低，输出越确定 MiniMax-M2 推荐使用 1.0 MiniMax-M1 默认值为 1.0，推荐范围 [0.8, 1.0] MiniMax-Text-01 默认值为 0.1，适用于答案明确的场景，对于文案生成等发散性场景可适当调高至 0.7-1.0

必填范围: 0 < x <= 1
​
top_p
number<double>
默认值:0.95

采样策略，影响输出随机性，取值范围 (0, 1]，各模型默认为 0.95，MiniMax-M2 推荐使用 0.95

必填范围: 0 < x <= 1
​
tools
object[]

可供模型选择调用的工具列表。更多详情参考 工具使用 & 交错思维链

​
tool_choice
enum<string>
默认值:auto

控制模型如何使用工具。none (不调用) 或 auto (自主决定)

可用选项:
none,
auto
​
response_format
object

指定模型输出的格式，当前仅 MiniMax-Text-01 支持此参数 设置为 { "type": "json_schema", "json_schema": {...} } 可强制模型按指定的 JSON Schema 结构输出

​
stream_options
object

响应

​
id
string

本次响应的唯一 ID

​
choices
object[]

响应选择列表

​
created
integer<int64>

响应创建的 Unix 时间戳（秒）

​
model
string

本次请求使用的模型 ID

​
object
enum<string>

对象类型。非流式为 chat.completion，流式为 chat.completion.chunk

可用选项:
chat.completion,
chat.completion.chunk
​
usage
object

本次请求的 Token 使用情况统计

​
input_sensitive
boolean

输入内容是否命中敏感词。如果输入内容严重违规，接口会返回内容违规错误信息，回复内容为空

​
input_sensitive_type
integer<int64>

输入命中敏感词类型，当input_sensitive为true时返回。取值为以下其一：1 严重违规；2 色情；3 广告；4 违禁；5 谩骂；6 暴恐；7 其他

​
output_sensitive
boolean

输出内容是否命中敏感词。如果输出内容严重违规，接口会返回内容违规错误信息，回复内容为空

​
output_sensitive_type
integer<int64>

输出命中敏感词类型

​
base_resp
object

错误状态码和详情