curl --request POST \
--url https://api.minimax.io/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: <content-type>' \
--data '
{
"model": "MiniMax-M3.1-Flash",
"reasoning": {
"effort": "max"
},
"input": "Which is bigger, 9.11 or 9.9?"
}
'{
"id": "07229fa44f3853da55eef9fb8bd29297",
"object": "response",
"created_at": 1792240804,
"model": "MiniMax-M3.1-Flash",
"status": "completed",
"output": [
{
"id": "07229fa44f3853da55eef9fb8bd29297_rs",
"type": "reasoning",
"status": "completed",
"summary": [],
"content": [
{
"type": "reasoning_text",
"text": "We need answer simple. Need explain decimals. 9.9 = 9.90, compare 9.11, 9.90 bigger. Need concise."
}
]
},
{
"id": "07229fa44f3853da55eef9fb8bd29297_msg",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "9.9 is bigger than 9.11, because 9.9 = 9.90 and 9.90 > 9.11.",
"annotations": []
}
]
}
],
"output_text": "9.9 is bigger than 9.11, because 9.9 = 9.90 and 9.90 > 9.11.",
"usage": {
"input_tokens": 218,
"output_tokens": 68,
"total_tokens": 286,
"input_tokens_details": {
"cached_tokens": 189
},
"output_tokens_details": {
"reasoning_tokens": 36
}
},
"error": null,
"incomplete_details": null,
"instructions": null,
"metadata": {},
"tools": null,
"tool_choice": "auto",
"temperature": 1,
"top_p": 0.95,
"text": {
"format": {
"type": "text"
}
},
"reasoning": {
"effort": "max",
"summary": null
},
"max_output_tokens": null,
"parallel_tool_calls": true,
"previous_response_id": null,
"conversation": null,
"store": false,
"service_tier": null,
"safety_identifier": null,
"truncation": "disabled"
}OpenAI Responses API
Create Response
Call MiniMax models via the OpenAI Responses API compatible main endpoint. Generates model replies, supports streaming and non-streaming.
POST
/
v1
/
responses
curl --request POST \
--url https://api.minimax.io/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: <content-type>' \
--data '
{
"model": "MiniMax-M3.1-Flash",
"reasoning": {
"effort": "max"
},
"input": "Which is bigger, 9.11 or 9.9?"
}
'{
"id": "07229fa44f3853da55eef9fb8bd29297",
"object": "response",
"created_at": 1792240804,
"model": "MiniMax-M3.1-Flash",
"status": "completed",
"output": [
{
"id": "07229fa44f3853da55eef9fb8bd29297_rs",
"type": "reasoning",
"status": "completed",
"summary": [],
"content": [
{
"type": "reasoning_text",
"text": "We need answer simple. Need explain decimals. 9.9 = 9.90, compare 9.11, 9.90 bigger. Need concise."
}
]
},
{
"id": "07229fa44f3853da55eef9fb8bd29297_msg",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "9.9 is bigger than 9.11, because 9.9 = 9.90 and 9.90 > 9.11.",
"annotations": []
}
]
}
],
"output_text": "9.9 is bigger than 9.11, because 9.9 = 9.90 and 9.90 > 9.11.",
"usage": {
"input_tokens": 218,
"output_tokens": 68,
"total_tokens": 286,
"input_tokens_details": {
"cached_tokens": 189
},
"output_tokens_details": {
"reasoning_tokens": 36
}
},
"error": null,
"incomplete_details": null,
"instructions": null,
"metadata": {},
"tools": null,
"tool_choice": "auto",
"temperature": 1,
"top_p": 0.95,
"text": {
"format": {
"type": "text"
}
},
"reasoning": {
"effort": "max",
"summary": null
},
"max_output_tokens": null,
"parallel_tool_calls": true,
"previous_response_id": null,
"conversation": null,
"store": false,
"service_tier": null,
"safety_identifier": null,
"truncation": "disabled"
}Authorizations
HTTP: Bearer Auth
- Security Scheme Type: http
- HTTP Authorization Scheme: Bearer API_key, used to authenticate your account. View it in Account Management > API Keys
Headers
Media type of the request body. Must be set to application/json
Available options:
application/json Body
application/json
Model name to invoke, e.g. MiniMax-M3.1-Flash
Example:
"MiniMax-M3.1-Flash"
Conversation content. Supports either a simple text or a full conversation history array
Service tier for request admission. Supported values are standard and priority. If omitted, the request uses the standard tier. The priority price is 1.5 times the standard price and ensures priority admission so the request is processed ahead of other requests, leading to faster responses and fewer failures. MiniMax-M3.1-Flash does not support this field.
Available options:
standard, priority System instructions
Maximum output token count. Reasoning tokens count toward it too, so a value that is too small yields status: "incomplete" with no message item in output.
Sampling temperature, range (0, 1]
Required range:
0 <= x <= 1Nucleus sampling, range (0, 1]
Required range:
0 <= x <= 1Set to true to enable SSE streaming response
Tool list
Show child attributes
Show child attributes
Tool selection strategy: auto lets the model decide whether to call tools
Available options:
auto Request metadata. Both keys and values are strings
Show child attributes
Show child attributes
Prompt cache routing identifier
Output format control
Show child attributes
Show child attributes
Reasoning control. The default depends on the model, so no schema-level default is declared.
MiniMax-M3.1-Flash: reasoning is always on, including whenreasoningis omitted.effortacceptslow,medium,high,xhighormax, and does tune reasoning depth. When omitted, it defaults tomax.effort: "none"returns HTTP 400.MiniMax-M3: reasoning is off unlesseffortis set to a non-nonevalue, which turns reasoning on but does not tune its depth.- M2.x models: reasoning cannot be disabled;
effort: "none"is accepted but ignored.
Show child attributes
Show child attributes
Response
Successful response
Response ID
Example:
"abc123"
Object type, always response
Available options:
response Response creation time (Unix seconds)
Actual model that processed the request
Example:
"MiniMax-M3.1-Flash"
Response status
Available options:
completed, incomplete, failed Model output list
- Message
- Reasoning
- Function Call
Show child attributes
Show child attributes
Convenience field: concatenates all text outputs
Show child attributes
Show child attributes
Error info, only returned when status=failed
Show child attributes
Show child attributes
Reason for incompletion, only returned when status=incomplete
Show child attributes
Show child attributes
This parameter is not supported in requests. If passed, it will be ignored, and the response always returns true.
This parameter is not supported in requests. If passed, it will be ignored, and the response always returns false.
This parameter is not supported in requests. If passed, it will be ignored, and the response always returns disabled.
Available options:
disabled This parameter is not supported in requests. If passed, it will be ignored, and the response always returns null.
This parameter is not supported in requests. If passed, it will be ignored, and the response always returns null.
The service tier actually applied to this request: standard or priority. MiniMax-M3.1-Flash does not support this field, so the response returns null.
This parameter is not supported in requests. If passed, it will be ignored, and the response always returns null.