跳转到主要内容
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": ""
}
}

Authorizations

Authorization
string
header
required

HTTP: Bearer Auth

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

Headers

Content-Type
enum<string>
default:application/json
required

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

Available options:
application/json

Body

application/json
model
enum<string>
required

模型 ID。可选值:MiniMax-M1, MiniMax-Text-01。注:MiniMax-M1 为推理模型,为获得最佳体验建议使用流式输出

Available options:
MiniMax-M1,
MiniMax-Text-01
messages
object[]
required

包含对话历史的消息列表

stream
boolean
default:false

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

max_tokens
integer

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

Required range: 1 <= x <= 8192
temperature
number

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

Required range: 0 < x <= 1
top_p
number
default:0.95

采样策略,影响输出随机性,取值范围 (0, 1],各模型默认为 0.95

Required range: 0 < x <= 1
tools
object[]

可供模型选择调用的工具列表

tool_choice
enum<string>
default:auto

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

Available options:
none,
auto
response_format
object

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

stream_options
object

Response

id
string

本次响应的唯一 ID

choices
object[]

响应选择列表

created
integer

响应创建的 Unix 时间戳(秒)

model
string

本次请求使用的模型 ID

object
enum<string>

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

Available options:
chat.completion,
chat.completion.chunk
usage
object

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

input_sensitive
boolean

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

input_sensitive_type
integer

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

output_sensitive
boolean

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

output_sensitive_type
integer

输出命中敏感词类型

base_resp
object

错误状态码和详情

I